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Introduction 


This booklet explains how to configure APPC and APPN on the following plat- 
forms: 


¢ Networking Services’ DOS 
© OS'2 

e AIX 

¢ VM 

¢ CICS 

¢ MVS 

¢ AS/400 


(See the individual chapters for details on product versions and prerequisites.) 


To configure APPC on different kinds of computers you need to know multiple, 
varying configuration methods. Terminology varies from one type of computer to 
another. There is a set of values that needs to match between two computers that 
want to communicate. 


This guide 1s designed to do three things: 
1. Describe the steps needed to configure APPC. 


2. Explicitly state which values in one computer’s configuration need to match 
values in a partner computer’s configuration. | 


3. Separate the terminology differences between computers by mapping to a set of 
standard terms, and confining platform-specific terms to the section that | 
descnbes that platform. 


This guide is not a tutonal on APPC or APPN concepts, although some APPC and 
APPN terms are introduced in this first section. It is also not a network design 
tutonal. A good introduction to APPC and APPN concepts is provided in two 
publications: Nenovorking with APPN: An Overview, G325-0204-00 and Communi- 
cating with APPC and CPI-C: A Technical Overview, 

G325-0202-00. Both are available from IBM. 


To keep things simple, configuration for a token-ring Local Area Network 1s explic- 
itly presented in this booklet. The information here should help you configure other 
types of networks, but additional information from the platform’s installation guide 
may be necessary in those cases. 


APING 


This guide uses a widely available APPC program called APING in the configura- 
tion examples. APING 1s a small program that sends data across a network and 
receives some data back. APING 1s used to test connectivity between two machines 
on a network, and to provide diagnostic information when APPC communications 
fail. APING is shipped as a sample program with Networking Services, DOS and 
Communications Manager/2. It is also available on several bulletin boards: 
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¢ CompuServe 


There 1s an APPC Info Exchange area on CompuServe (type GO APPC to 
access it when in CompuServe). In the Library section, there are several pack- 
ages related to APING: 


— APING.ZIP - The OS/2 APING executables, C source code, and makefiles 
for many platforms. 


— APINGS.ZIP - The C source portion of the APING.ZIP package. 

— PNGFAM.ZIP - The executables from the APING.ZIP package. 

— APINGC.ZIP - the CICS COBOL source for the APINGD server. 
¢ MKTTOOLS 


MKTTOOLS 1s an IBM-internal bulletin board containing packages that can 
be distributed to customers. IBM marketing reps and SE’s have access to this 
bulletin board and can request packages from it. The packages related to 
APING are: 


— APING PACKAGE: The OS/2 APING executables, C source code, and 
makefiles for many platforms. 


— APINGCIC PACKAGE: the CICS COBOL source for the APINGD 


server. 
¢ OS2BBS 


The OS2BBS 1s a bulletin board accessible through IBM Information ‘Network. 
The APING package 1s available on. the OS2BBS. 


— APING.ZIP: The OS/2 APING executables, C source code, and makefiles 
for many platforms. 


The APING package consists of a client program, APING, and a server program 
APINGD. We recommend that you obtain APING and use it when you configure 
APPC in your network. 


When you finish configuring both partners, you can run APING on the client 
machine. When APING successfully exchanges information with a partner, the fol- 
lowing information (with timing vanations) 1s displayed. 


APING version 2.35 APPC echo test with timings. 
by Peter J. Schwaller (pjs@ralvm6.vnet. ibm.com) 


Allocate duration: 1711 ms 


Program startup and Confirm duration: 689 ms 


Duration Data Sent Data Rate Data Rate 
(msec) (bytes) (Nb/s) 


Totals: 60 


Duration statistics: 


Figure 1. Results from APING 


Multi-platform APPC Configuration Guide 


Using this guide 


This guide contains a chapter for each platform. Each chapter describes that plat- 
form’s configuration independent of the type of machine it will be connecting to. 
Within each chapter, when parameter values are needed from a partner computer, 
the instructions will say: “See the ‘How to find...’ section of the partner computer’s 
configuration chapter.” The person using that partner computer’s configuration 
chapter should be able to read the “How to find...’ instructions and provide the 
proper value. 


Each chapter assumes some knowledge of the operation of that platform. No 
APPC or APPN knowledge 1s required, but someone configuring Networking 
Services DOS, needs to know how to edit a text file in DOS, and how to copy files 
for example. 


If there are different people configunng different platforms, for example, when trying 
to connect OS:2 to an AS 400, this is what you should do: 


1. Give the chapter on OS/2 to the OS/2 operator. 
2. Give the AS’400 chapter to the AS/400 operator. 


3. Each person fills in the values in the platform Configuration Worksheet at the 
beginning of their chapter. You need to obtain specific values from the person 
who is configunng the platform that you want to connect to. Instructions for 
finding this information are in the “How to find...” section of their chapter. 


4. Each person follows the configuration directions in their chapter, filling in the 
appropniate values from the Configuration Worksheet. 


5. If you need more details about a platform’s configuration, you should refer to 
documents listed at the beginning of each chapter. 


In this manner, the OS ‘2 operator never needs to learn the AS 400 configuration 
terminology (unless the same person 1s the operator of both machines). 


Fach chapter in this booklet 1s not only independent of the partner computer’s plat- 
form, but also independent of the network structure. This means that the con- 
nection between computers is descnbed as a direct connection from one computer 
to the other. However, configuration can get complex when a computer starts con- 
necting to several partner computers. This complexity 1s unnecessary when a special 
kind of node called a network node 1s added to the network. A network node is 
used to locate partners in a network. (Network nodes are discussed in more detail in 
“What Is APPN?” on page 6.) 


If you have a network node in your network, you can define just one link to it, and 
avoid defining the many individual links to the other computers in the network that 
can be located by the network node. The chapter for each platform describes how 
to substitute a link to a network node for many direct links to partner machines. 
The way to find out if vou have a network node in your network 1s to ask someone 
who set up the network. That person should be able to provide you with the neces- 
sary information about the network node for you to include it in your configuration. 
If vou don’t have a network node, or don’t know if you have one, you can continue 
to follow the directions that assume there is no network node. The only drawback 
is that this may add unnecessary complexity to your network. 
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What are Logical Units and Sessions? 


What Is APPC? 


Advanced Program-to-Program Communication (APPC) is software that enables 

high-speed communications between programs on different computers, from port- 
ables and workstations to midrange and host computers. APPC software 1s avail- 
able for many different IBM and non-IBM operating systems, either as part of the 
operating system or as a separate software package. 


APPC serves as a translator between application programs and the network. When 
an application on your computer passes information to the APPC software, APPC 
translates the information and passes it on to a network interface, such as a LAN 
adapter card. The information travels across the network to another computer, 
where the APPC software receives the information from the network interface. 
APPC translates the information back into its original format and passes it to the 
corresponding partner application. 


What are Transaction Programs and Conversations? 


The part of an application that initiates or responds to APPC communications is 
called a transaction program or TP. A transaction program on your workstation 1s 
not an entire, stand-alone program. Instead, it is the part of the program that 
handles transactions (exchanges of data) with another program. 


_ When people talk with each other, we say that they are having a conversation. 


Likewise. the communication between two transaction programs 1s called a corver- 
SALON. 


A conversation between two programs is similar to conversation between two 
people. When you have a conversation with another person, you follow unwnitten 
rules that govern how you begin and end the conversation, take turns speaking, and 


~ exchange information. Similarly, APPC is called a protocol because it provides the 


rules that govern how conversations between transaction programs start and stop, 
which program “speaks’’ first, and how data 1s exchanged. 


A program in your computer may have several conversations active at one time, 
with the same transaction program or with different transaction programs. 


What are Logical Units and Sessions? 


When two people in different buildings want to talk to each other, they must use 
their telephones. Simuarly, transaction programs in different computers can’t talk 
directly to each other. Instead, they converse over sessions between two logical 
units. 


A logical unit or LU 1s APPC software that serves as an interface or translator 
between a transaction program and the network. A logical unit manages the 
exchange of data between transaction programs.. 


An LU is located on your computer. A partner LU is located on a partner com- 
puter. 
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What Is a Network? 


Before a transaction program can start a conversation with a partner transaction 
program, APPC must establish a session, the session that connects the local LU and 
the partner LLU. 


There is a one-to-one relationship between a conversation and a session. A session 
can support only one conversation at a time. However, as soon as that conversa- 
tion ends, another conversation can use the session. So, compared to conversations, 
sessions are long-lived connections. 


What Is a Mode? 


A mode 1s a set of parameters that defines the characteristics of a session between 
two LUs. Modes have names that must match exactly. There are 5 modes prede- 
fined on most platforms that can be used by most applications. (Two more modes, 
SNASVCMG and CPSVCMG, are also defined, but they are not intended to be 
used directly by applications.) The SC suffix in the mode name means the defi- 
nitions include secunty. 


¢ #INTER  - for interactive jobs 

¢ #BATCH  - for batch jobs 

¢ #INTERSC - for interactive secured jobs 

¢ #BATCHSC - for batch secured jobs 

¢ #CONNECT - an average between #INTER and #BATCH 


What Is CPI-C side information? 


CPI-C, Common Programming Interface Communications, provides a consistent 
application programming interface for applications that require APPC. 


CPI-C programming provides a mechanism, called side information which associates 
a set of parameters with a specified symbolic destination name. The CPI-C 
program then uses the symbolic destination name to initialize a conversation. This 
information includes: 


CPI-C Svmbolic destination name 
The name used to refer to the CPI-C side information entry. 


TP. name 
The name used to identify which program to start on the partner computer. ~- 


LU name 
The name of the partner LU 


mode name 
The characteristics associated with the session between the LUs. 


~ What Is a Network? 


Transaction programs in different computers must use a network to communicate 
with each other. APPC provides the interface between the programs and net- 
working software and hardware. 
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What Is APPN? 


In simplest terms, a network consists of components that connect computers. 
These components are: 
Node 
A node is any computer in the network. For example, if your DOS work- 
station 1s connected to an OS/2 workstation, both computers are nodes. 
Link _ 
A link is a physical or logical connection between two adjacent nodes. 


Before data can be sent between two nodes, a link must be active between them. 


What Is APPN? 


Advanced Peer-to-Peer Networking (APPN) provides networking functions for 
APPC applications. 


When configunng a node in a network, you must decide which type of node to con- 
figure. Types of nodes in an APPN network are: 


Low-entry networking node (LEN) 
Low-entry networking nodes are the simplest node type and have the least 
function. A low-entry networking node must be an end point in the network; 
it cannot function as an intermediate node. A LEN is capable of peer-to-peer 
communication, but unable to make direct use of APPN functions. Most 
end-user computers should be EN’s. However, some platforms can only be 
LEN nodes, e.g., NS’DOS. 


End node (EN) 
An end node provides the functions of a low- -entry networking node plus the 
ability to register information about itself with a network node. This ability 
helps reduce the amount of network configuration required. 


_ Network node (NN) 


NN’s are used to locate partners in an APPN network. If there is a NN in 
the network, an end node can define one link to the network node. The EN 
then requires no other link definitions. Typically, there is at least one network 
node in a network but the addition of more requires informed network anal- 
ysis. 


What is a Control Point(CP) ? 


In APPN, a control point is responsible for managing the node and its resources 
and, in an APPN end node, for communicating with an adjacent network node 
server's control point to obtain APPN network services. A control point is an LU 
and it might be the only LU at that node. Whenever possible the CP should be the 
only LU at anode. Platforms that are LEN only do not use the control point. 


What is Subarea Networking? 


Subarea networks existed pnor to APPN. As opposed to APPN, subarea networks 
are hierarchical in nature. The software that implements subarea networks runs in 
host computers and communication controllers attached to those hosts. The host 
software is called VTAM (Virtual Telecommunications Access Method), and the 
communication controller software is called NCP (Network Control Program). 
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How do I Configure a Network? 


Nodes in APPN networks can have links to subarea networks and can establish ses- 
sions and conversations with LUs and TPs in those networks. From the perspective 
of the APPN node the entire subarea network is viewed as a LEN node. Resources 
in the subarea network can then be defined in the APPN node as though they all 
were contained in one LEN node. 


What is a Node Identifier? 


Note: Some SNA products require partner systems to code a specific value for a 
parameter called the node identification or node id for short. The two systems pass 
this node identifier during the link activation in a message unit called exchange iden- 
tification or “XID.” Node identifiers for each specific platform are described in the 
appendix. See Appendix A, “Using Node IDs in VTAM” on page 109. 


We discourage use of node identifiers, preferring the CP name because it is more 
genenic and less confusing. 


How do | Configure a Network? 


This section provides an overview of the steps required to configure APPC. Config- 
uration is descnbed by using a standard terminology. These standard terms are used 
throughout the guide to discuss configuration. Each platform may use platform- 
specific terms in its configuration instead of the standards tems. Therefore, each 
chapter contains a terminology mapping chart that cross-references the terms below 


with platform-specific terms. 


The steps to APPC configuration are: 
¢ Define yourself to the network. 
To define yourself to the network, you must define these parameters: 
— Network Name 


A network is a set of interconnected nodes that are grouped by a common 
identifier called a nenyvork name. The network name 1s a | to 8 character 
field consisting of alphanumeric characters. There 1s a structured format for 
the network name which includes the country code, enterprise code and 
network suffix code. This format insures uniqueness around the world. 

Call your local IBM branch office for the format information and to register 


your network name. 
— LU name 


1 to 8 character field consisting of alphanumenc characters which is the LU 
name of the node. Choose a name that is unique within the network name. 


The fully qualified name is represented as two concatenated names, the network 
name and the LU name, separated by a penod (NETNAME.LUNAME). This 


unique name identifies the node. 
¢ Define a link to your partner 


— You can define a direct link between the local node and the partner node if 
both nodes are in the same local network. 


— If there 1s a network node (NN) in the local network, you can define a link 
to the NN, and the NN can locate the partner node. 


Introduction 7 


How do I Configure a Network? 


— If the partner node is located in a VTAM subarea, you can define a link to 
the VITAM subarea, and the VTAM subarea can locate the partner node for 
you. 


To define a link, you must define these parameters: 
— Network Name 


This is the Network Name of the partner machine. To determine this 
value, refer to the “How to find...” section of the partner machine’s config- 
uration chapter. 


— Partner LU Name 


This is the LU name of the partner machine. To find this value, refer to 
the “How to find...” section of the partner machine’s configuration chapter. 


— Adjacent LAN Address 


This is the address of the adjacent node or the network node you are con- 
necting to. In a token ring, this is the address of the token ring card at the 
adjacent node. To find this value, refer to the “How to find...” section of 
the partner machine’s configuration chapter. 


¢ Define partner LU name 


If you ARE NOT using a network node in your network, you must define a 
partner LU name. This will allow the partner to be located. 


— Partner LU Name 


This is the Local LU name defined on the partner machine. To find this 
value, refer to the “How to find...” section of the target machine’s configura- 
tion chapter. 


If you ARE using a network node in your network, you do not need to define 
an explicit partner LU name. However, you will need to know the partner LU 
name when running transaction programs. 


CPI-C Side Information may be used to associate a set of parameters, including 
the partner LU name, with a symbolic destination name. The symbolic destina- 
tion name can then be used when running transaction programs to specify the 
partner. Each platform has directions for configunng CPI-C side information. 


¢ Configure to run as a server 


If you are configunng your computer to run as a server, a transaction program 
must be configured on your computer. The transaction program will be the 
target of a conversation started by a client. 


— JP name 


] to 64 alpha-numenic characters. This is the name specified by the partner 
APPC application when it wants to start a conversation with a TP on your 
computer. 
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AIX SNA Services/6000 Configuration 


Prerequisites 


Terminology 


This chapter explains how to configure AIX SNA Services/6000. AIX SNA 
Services 6000 1s IBM's rmplementation of APPC for AIX. Version 1.2 only sup- 
ports low entry networking nodes (see “What Is APPN?” on page 6 for a discussion 
of SNA node types). The machine to be configured should have AIX version 3.2 
and SNA Services version 1.2 with the latest updates applied. This is necessary to 
get the maximum benefit of APPC, including CPI-C support, and mode definitions. 
To check the level of SNA Services you have installed, run the command 


Islpp -h sna.sna.obj 
The result should contain four numbers similar to this: 
01.02.0000.0000 


If the last number 1s “0000”, you do not have the latest updates. You should apply 
PT h}’s U411903 and U411904. If the last number 1s “0224” (indicating the July, 
1992 quality refresh) or “0244” (indicating the December, 1992 quality refresh), then 
your SNA Services are sufficiently updated. 


This document descnbes all of the profiles that need to be created to configure an 
AIX machine to run APING to another machine. A few profiles may be left out if 
you don't plan to run this ATX machine as a server. These will be noted. To con- 
figure Transaction Programs other than APING and APINGD on this machine, see 
the discussion under “Configure to run as a server” on page 22. | 


e AIX V3.2 
e AIX SNA Services/6000 V1.2 with PTF’s U411903 and U411904 


¢ Token-ring adapter 


For more detailed configuration information, refer to the following publications: 
e Using ALY SNA Services:6000, SC31-7002 
© AIX SNA Services'6000 Reference, SC31-7014 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by SNA Services/6000. 
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SNA Services/6000 Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by referring to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (7), the middle column describes 
what the variable 1s used for and how to determine the value, and the nght-most 
column is for you to fill in with a value. Whenever there is a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
right column. | 


For example, if you are following the recommendations in the Worksheet, you will 
write #/.\7ER in the nght column on the ?MODE? line. Then in Figure 13 on 
page 21 you will type #INTER in the “MODE name’ field to replace “PMODE” 
like this: 


CPI Communications Side Information 


PROFILE name = 2?SYMDEST? 
PARTNER LU name = 2CALLCONNPRO? 
REMOTE TRANSACTION PROGRAM name = ?TPNAME? 
SERVICE transaction program? = no 

MODE name = #INTER 


Figure 2. CPI Communications Side Information 


Symbol How to determine the value for this symbol Fill in value 
| : here 


Values that must match with other places 


2LUNAME? 


This is the symbol that refers to the LU name of the 
machine you are defining to the network. It 1s a 1 to 8 char- 
acter field consisting of alphanumeric characters which is the 
LU name of the node. Choose a name that 1s unique within 
the same network. Refer to “Hlow do I Configure a 

Network?” on page 7 for information about LU names. 


This is the symbol that refers to the Control Point name of 
your machine. It same as your 7LUNAME?. Refer to 
“What Is APPN?” on page 6 for more information about 
control points. : 


2CPNAME? 


INETWORK? This is the symbol that refers to the network name of the 
machine you are defining to the network. It is a 1 to 8 char- 
acter field consisting of alphanumenc characters. There is a 
structured format for the network name which includes the 
country code, enterprise code and network suffix code. This 
format insures uniqueness around the world. Call your local 
IBM _ branch office for the format information and to register 
vour network Refer to “How do I Configure a Network?” 
on page 7 for more information about network names. 
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Symbol Iluw to determine the value for this symbol Fill in value 
here 


2PARTNERLU? This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for 
this value. Refer to “How do I Configure a Network?” on 
page 7 for more information about the partner LU name. 


27PARTNERNET? This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s 
“How to find...” section. Refer to “How do I Configure a 
Network?” on page 7 for more information about the 


partner network name. 


?LANADDRESS? This 1s the symbol for the LAN Address of the partner com- 
| puter. (Or the LAN Address of a network node, if the link is 
being made to a network node.) Refer to the “How to 
find...” section of the partner computer’s configuration 


chapter for this value. 


JT PNAME? This is the symbol for the Transaction Program name. This 
is the name of the transaction program at the partner com- 
puter. For APING, the TP Name on the server is 


APINGD. 


7TPPATH? This is the symbol for the fully specified path and filename 
of the executable code for a server transaction program 
located on your machine. For APINGD, this may be: 

Nocal/sna/apined. 


2 MODE? This is the symbol for the mode name. See “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client ‘server product’s documentation specifies what mode 
must be used by that product. APING can use any mode 
(this can be specified on the APING command line), but the 
default is HINTER. It is recommended that you use one of 
the architected modes discussed in the “What Is a Mode?” 
section. 


Local values 


°SYMDEST? This is the symbol for the CPI-C side information symbolic 
destination name. It is any 1-8 character name you choose. 


It will be used locally on the AIX machine to refer to a 
CPI-C side information entry. See “What Is CPI-C side 
information?” on page 5 for more information on CPI-C 
Side Information. 


Note: The December 1992 quality refresh of SNA 

Services 6000 fixes an error that would require you to specify 
a symbolic destination that 1s exactly eight characters long 
when running APING. If you only have the July 1992 
quality refresh (see -- Heading “AIXNINTR’ unknown --), 
you should specify an eight character symbolic destination 
name. 
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Symbol | How to determine the value for this symbol | Fill in value 
here 


The following are the names of the profiles that must be configured. The profile names must be 1 to 14 
characters long (unless otherwise indicated). The profile names are referenced only on the machine you 
are configuring, and do not need to match any values on other machines. Some suggestions for profile 
names are provided. 7 


If you are using Quick Configuration, you only need to fill in a value for the first symbol below 
(QUICKPRO?). All the profile names generated for the Quick Configuration will be the same (except 
the Transaction Program and Mode profile names which are slightly modified). 


2?QUICKPRO? The symbol for name that Quick Configuration uses to gen- 
erate profile names for all the profiles it creates. You don’t 
‘need this value if you are not using Quick Configuration. 
This value 1s 1-12 characters long. Suggestion: use the same 
value as that used for the 7PARTNERLU? symbol. 


%CPPRO? | The symbol for the name of the Control Point profile. Sug- 
gested profile name: CPPRO 


| ?7LUPRO? The symbol for the name of the Local Logical Unit 6.2 
profile. Suggested profile name: MYLUPRO 
The symbol for the name of the Outgoing (CALL) Attach- 


°CALLATTACHPRO? | 
| | ment profile. Suggested profile name: CALLATT 


| Note: The attachment profile names are only 1-8 characters 
long. 


27LISTATTACHPRO? | | The symbol for the name of the Incoming (LISTEN) 
Attachment profile. Suggested profile name: LISTATT 


Note: The attachment profile names are only 1-8 characters 
long. 


%CALLCONNPRO? | The symbol for the name of the Outgoing (CALL) Con- 
| nection profile. Suggested profile name: CALLCONN 


| oLISTCONNPRO? | The symbol for the name of the Incoming (LISTEN) Con- 
| nection profile. Suggested profile name: LISTCONN 


en ee 


MODEPRO? The symbol for the name of the Mode Profile. To avoid 
| | defining new modes, use one of the mode profiles already 
supplied by SNA Services/6000: 


e INTER 

¢ BATCH 

© INTERSC 
¢ BATCHSC 


Note that these are the mode profile names. The actual 
modes defined by them are: #INTER, #BATCH, 
#INTERSC, and sBATCHSC. Which one to choose may 
depend on the requirements of your client/server application, 
as specified in its documentation. See ‘What Is a Mode?” 
on page 5 for a discussion of these modes. To use the 
default mode that APING uses, specify INTER. 
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Symbol How to determine the value for this symbol Fill in value 
| here 


IMODELIST PRO? The symbol for the name of the Mode List profile. Sug- 
gested profile name: MODELIST 


29RTPNAMEPRO? The symbol for the name of the Remote Transaction 
Program Name profile. This value must not be the same as 
anv local Transaction Program Name profiles 
(7TPNAMEPRO?). Suggested profile name: use the 
7PPNAME? value, followed by an “R”. (For APING, this 
would be APINGDR.) If this machine is being configured 
as a server only, you do not need to create any Remote 
Transaction Program Name profiles. 


29RTPLISTPRO? The symbol for the name of the Remote Transaction 
Program List profile. Suggested profile name: RIPLIST If 
not try to start transaction programs on the partner 


this machine 1s being configured just as a server (1.e. it will 
machine), vou do not need to create a Remote Transaction 


Program List profile and can use the default profile provided 
by SNA Services, 6000 called RDEFAULT. 


JTPNAMEPRO? The symbol for the name of the Transaction Program Name 
profile. Suggested profile name: use the value for 
?TPNAME? folowed by “PRO”. For example: 
APINGDPRO If you will not be running this machine as a 
server. vou do not need to configure any Transaction 

Program Names, and will therefore not need this value. 


2TPNLISTPRO? The symbol for the name of the Transaction Program List 
profile. Suggested profile name: TPNLIST. If you will not 
be running this machine as a server, you do not need to con- 
figure transaction programs on it. In this case, use the 
default Transaction Program List profile name, 
TDEFAULT. 


Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Detine a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 


4+. Configure to run as a server 
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a. Define transaction programs 


b. Other server configuration 


SNA Services stores its configuration information within encoded profiles that are 
accessed using the System Management Interface Tool (SMIT). 


Within SMIT, SNA Services configuration panels can be accessed by selecting the 
following senes of panels: 


--Communications Applications 
--SNA Services 
--Configure 
--Advanced Configuration 


For the rest of this discussion, other panels will be specified from this base level 
within SMIT. 


The user should have the base configuration of AIX SNA Services installed and 
have “system group” access to the system in order to run SMIT and start the SNA 
subsystem. “System group” authority is required to make the changes suggested in 
this document. See the document, Using AIX SNA Services/6000, SC31-7002, for 
more information on SNA Services installation. 


For this discussion, we will progress through a basic configuration that allows both 
an outgoing and incoming APING operation to be performed. This chapter 
describes how to configure a workstation that is attached to a Token Ring LAN and 
assumes the token ring DLC has been created by the system. Other DLC’s wil 
require Attachment Profile definitions that would replace the Token Ring Attach- 
ment Profile described below. 


There are several profiles that need to be defined: 
1. A Control Point Profile 
. A Local LU (6.2) Profile 


. 2 Token Ring Attachment Profiles 


tv 


Two Logical Connections Profiles 
A Mode List Profile 

. A Remote TP Name Profile 

. A Remote TP Name List Profile 

. A CPI-C Side Information Entry 

. A TP Name Profile 

10. A TP Name List Profile 


O GO ~) ON in 


Quick Configuration 
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AIX SNA Services,'6000, with the PT Fs specified above, provides a “Quick Config- 
uration” utility that creates all of the above profiles based on information entered on 
just one or two SMIT panels. This Quick Configuration 1s an excellent way to con- 
figure a simple connection to a partner machine using a single mode definition and a 
single transaction program definition. Quick Configuration 1s designed for just such 
a scenano. Quick Configuration does not reuse profiles that have already been 
defined. So, if you repeatedly use Quick Configuration to define connections to 
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partners, then multiple LU profiles, mode profiles, mode list profiles, etc. will be 
defined. It is recommended that if you choose to use Quick Configuration that you 
use it to define the first connection to a partner, but from then on to follow the 
explicit instructions for adding or updating the other profiles. 


Verifying configuration 


Once the profiles are created, they can be verified using either the command 
verifysna, or in SMIT by following this hierarchy of panels: 


--Communications Applications 
--SNA Services 
--Configure SNA Profiles 
--Advanced SNA Configuration 
--Verify SNA Configuration Profiles 


Starting and stopping APPC 


Configuration 


APPC 1s part of the AIX SNA Services ’/6000 subsystem. You can use the following 
command to test the status of the SNA subsystem: 


Issrc -l -S Sna 


If the SNA subsystem is not started, it can be started with the command: 
Startsrce -S sna 


If vou want the partner computer to be able to initiate a conversation to this AIX 
machine, you need to start the listen attachment before your partner attempts to 


activate the Lik between the two. Do this with this command: 
startsrc -t attachment -o LISTEN 


Note: The “LISTEN” value must match the “PROFILE name” of the Token Ring 
Attachment profile defined as the incoming, or “listen” attachment. 


To stop the SNA subsystem, execute this command: 


stopsrc -S sna 


Quick Configuration 


1. From within SMIT, follow these panels: 


--SNA Services 
--Quickly Configure an LU 6.2 Connection 


to 


. Enter a 1-12 character name (This is the value you filled in for the 
2?QUICKPRO? symbol in the Worksheet). All profiles created during this quick 
configuration will contain this name. 


3. Specify “no” when asked if you wish to configure to an existing network attach- 
ment. 

4. Select a default network ATTACHMENT type: token_ring_listen if your 
partner wiull initiate the conversation, token_ring_call if you will be initiating the 
conversation. To allow both actions, you will need to add another attachment 
profile after Quick Configuration, or follow the non-Quick Configuration 
instructions below. 
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The following figure shows the Quick Configuration panel. Replace the 
symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change 
any other values that are highlighted. 


Quick Configuration NAMES 

Fully qualified LOCAL LU name 
Local LU ADDRESS 

HODE name 

Local Transaction Program name 
Fully qualified REMOTE LU name 
Remote Transaction Program name 
ATTACHHENT | 

Link ADDRESS 


2QUICKPRO? 

2NETWORK?. 2LUNAME? 

8 

2M0DE? 

2TPPATH? 

2PARTNERNET?. 2PARTHERLU? 
2T PHAHE ? 

?QUICKATTACH? #see note } 
2LANADDRESS? #see note 2 


- 
= 
- 
= 
- 
= 
= 
= 
- 
= 
- 
= 
= 
= 
~ 
4 
= 
= 


Figure 3. Quick Configuration panel. 


Notes: 
a. The value in this field is already fixed when this panel is diaplayed. 
b. This field only appears if this configuration 1s based on a Call attachment. 


5. You should now have a connection to a partner properly configured. Skip to 
“Running APING” on page 23. The following descnptions for adding profiles 
should be used to understand the profiles that were created by Quick Configura- 
tion, and to expand the configuration (by adding transaction program profiles, 
mode profiles, and more connection profiles that reference the profiles already 
created by Quick Configuration). 


Define yourself to the network 


Create Control Point profile 
A control point must be defined to run APPC on SNA Services. This definition 1s 
done by adding a Control Point profile. 


From within SMIT, the Control Point profile can be accessed by following this 
series of panels: 
--Nodes 

--Control Point 


The following figure shows the Control Point profile panel. Replace the symbols 
(the words beginning and ending with question marks) with the corresponding 
values from the Configuration Worksheet. 


PROFILE name 
XID node ID 


2CPPRO? 

00000000 # see note 
2HETWORK? 

2CPNAME ? 


HETWORK name 
CONTROL POINT name 


t tf 8 OR 


Figure 4. Control Point profile 
Note: It is not recommended that you use an XID node ID for configuration. See 


Appendix A, “Using Node IDs in VTAM” on page 109 for a discussion of whether 
~ you should, and if so, what value to use here. 
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Create a local LU 6.2 Profile 
The local LU 6.2 profile must also be added. Its definition follows. 


From within SMIT, this can be accessed via: 


--Logical] Units 
~-LU6.2 
--LU6.2 Local Logical Unit 


The following figure shows the Control Point profile panel. Replace the symbols 
(the words beginning and ending with question marks) with the corresponding 
values from the Configuration Worksheet. 


?LUPRO? 
2TPHLISTPRO? 
2HETWORK? 
2LUHANE ? 

yes 

l 


* 


PROFILE name 

TPH LIST profile name 
NETWORK name 

Local LU NAHE 
INDEPENDEHT LU? 

Local LU ADDRESS 
SSCP ID 


Figure 5. Local LU6.2 profile 


Define a link to a partner or network node 
Next, the partner LU and link need to be defined in order for a connection to the 
partner LU to be established. There are two types of links that can be defined. 
One type of link allows this machine to initiate a connection to the partner com- 
puter. This link is called a “call’ attachment. The other allows the partner com- 
puter to initiate a connection with the local computer. This link 1s called a “listen” 
attachment. Both attachments must be defined if both partner and local computers 
wish to be able to imitiate a connection. The listen attachment must be started 
before the partner attempts to activate the link. Instruction on starting the link 1s 
discussed in “Starting and stopping APPC” on page 15. 


Create a Token Ring Attachment profile (LISTEN or incoming) 
From within SMIT, the Token Ring Attachment profile can be accessed by fol- 
lowing this senes of panels: 


--Physical Units 
--Token Ring 
--Token Ring Attachment 


The following figure shows the Listen (incoming) Attachment profile panel. 
Replace the symbols (the words beginning and ending with question marks) with 
the corresponding values from the Configuration Worksheet. You'll also need to 
change any other values that are highlighted. 
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PROFILE name 

CONTROL POINT profile name 
LOGICAL LINK profile name 
PHYSICAL LINK profile name 
STOP ATTACHMENT on inactivity? 
inactivity TIMEOUT 

LU address REGISTRATION 
REGISTRATION PROFILE name 
CALL type 

AUTO-LISTEN? 

MINIMUM SAP address 
MAXIMUM SAP address 

ACCESS ROUTING 

REWOTE LINK name 

Remote LINK address 

Remote SAP address 


2LISTATTACHPRO? 
2CPPRO? 
TOEFAULT 
TOEFAULT 
no 

0 

no 
LDEFAULT 
listen 
yes 

64 

EC 
link_name 


00000800000 
04 


“et tt f W # tf fF ff tt 8 f HH 8 of 


Figure 6. Token Ring Attachment Profile (LISTEN or incoming) 


Create a Token Ring Attachment profile (CALL or outgoing) 

The following figure shows the call (outgoing) Attachment profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 


other values that are highlighted. 


Token Ring Attachment profile (CALL) 
PROFILE name 
CONTROL POINT profile name 
LOGICAL LINK profile name 
PHYSICAL LINK profile name 
STOP ATTACHHENT on inactivity? 
inactivity TIMEOUT ; 
LU address REGISTRATION 
REGISTRATION PROFILE name 
CALL type 
AUTO-LISTEN? 
MINIMUM SAP address 
MAXIMUM SAP address 
ACCESS ROUTING 
REMOTE LINK name 
Remote LINK address 
Remote SAP address 


of tt # f ff tf H HH ff Hh tt HH HW HH 8 


?CALLATTACHPRO? 
2CPPRO? 
TDEFAULT 
TDEFAULT 

no 

0 

no 

LDEFAULT 


link_address 


?LANADDRESS? 
64 


Figure 7. Token Ring Attachment profile (CALL or outgoing) 


Define Logical Connections 
The connection profile specifies the attachment profile to be used to activate the 
partner, the partner LU name, and the Remote Transaction Program (RTP) name 
list. Again, in order to act as both client and server, separate connection profiles 
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must be defined. 


From within SMIT, the Logical Connection profiles can be accessed by following 


this senes of panels: 


--Logical Units 
--LU6.2 
--LU&.2 Logical Connection 
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Create Logical Connection profile (CALL): The following figure shows the CALL 
Logical Connection profile panel. Replace the symbols (the words beginning and 
ending with question marks) with the corresponding values from the Configuration 
Worksheet. You'll also need to change any other values that are highlighted. 


PROFILE name = 2CALLCONHPRO? 
ATTACHHENT profile name ?CALLATTACHPRO? 
LOCAL LU profile name 2LUPRO? 

NETWORK name ?PARTNERNET? 
STOP CONHECTION on inactivity? no 

TIMEQUT = 0 

REHOTE LU name ?PARTHERLU? 


SECURITY Accepted conversation 
CONVERSATION SECURITY ACCESS LIST eof le = CONVDEFAULT 
REMOTE TPN LIST profile name 2RTPLISTPRO? 

NODE LIST profile name ?MODELISTPRO? 
INTERFACE type extended 

SESSTOW CONCURRENCY parallel 

Hode VERIFICATION? no 


Figure §. Logical Connection profile (CALL) 


Create Logical Connection profile (LISTEN) 
The following figure shows the LISTEN Logical Connection profile panel Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 
_ other values that are highlighted. 


?LISTCOHNPRO? 
2LISTATTACHPRO? 
?LUPRO? 
?PARTHERNET? 

no 

0 

?PARTHERLU? 
conversation 
rofile = CONVYDEFAULT 
2RTPLISTPRO? 
2MODELISTPRO? 
extended 
parallel 

no 


PROFILE name 

ATTACHHEHNT profile name 

LOCAL LU profile name 

HETWORK name 

STOP CONNECTION on inactivity? 
TIMEOUT 

REHOTE LU name 


SECURITY Accepted 

CONVERSATION SECURITY ACCESS LIST 
RENOTE TPN LIST profile name 

HODE LIST profile name 

INTERFACE type 

SESS1OlH CONCURRENCY 

Hode VERIFICATION? 


wo nw Hf 


i 


Figure 9. Logical Connection profile (LISTEN) 


Configure to run as a client 
To run as a client, the following information needs to be configured: 


¢ the modes to be used, 
¢ the names of the Transaction Programs to run on the target machines, and 


¢ optionally, CPI-C Side Information. 
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Define the Mode List 


The mode list contains the names of the mode profiles that can be used by a trans- 
action program. 


From within SMIT, the mode profile list can be accessed by following this series of 
panels: 


--Logical Units 
--LU6.2 
--LU6.2 Mode List 


The following figure shows the Mode List profile panel. Replace the symbols (the 
words beginning and ending with question marks) with the corresponding values 
from the Configuration Worksheet. You can add more than one profile to this list. 


Mode List 
PROFILE name = 2MODELISTPRO? 


Hame } ?HODE PRO? 
Name 2 2HODEPRO2? 
Hame 3 2MODEPRO3 ? 


Figure 10. Mode List 


Create the Remote TP Name profile 


20 


The remote TP profile specifies a Transaction Program that will be run on the 
partner machine. A Remote TP Name list is then created to collect a set of Remote 
TP Name profiles. Neither the Remote TP Name profiles nor the Remote TP 
Name list need to be created if this machine will only be running as a server. 


From within SMIT, the Remote TP Name profile can be accessed by following this 
senies of panels: 


--Logical Units 
--LU6.2 
--LU6.2 Remote Transaction Program Name 


The following figure shows the LISTEN Logical Connection profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 
other values that are highlighted. 


Remote TP Name profile 
PROFILE name 
RTPN name is in HEXADECIMAL? 
RTPN name 


?RT PHAME PRO? 
no 

?TPNAME ? 

no 

mapped 
no_reconnect 
confirm 


PIP data? 
CONVERSATION type 
RECOVERY level 
SYNC level 


Figure 11. Remote Transaction Program Name 
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Create Remote TP Name List profile 
From within SMIT, the Remote TP Name List profile can be accessed by following 
this senes of panels: 


--Logica] Units 
--LU6.2 
--LU6.2 Remote Transaction Program Name List 


The following figure shows the Remote TP Name List profile panel. Replace the 
symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. 


PROFILE name = ?RTPLISTPRO? 
Name 1 = ?RTPNAHEPRO? 


Figure 12. Remote Transaction Program Name List profile 


Note: More remote transaction programs can be configured by creating more 
Remote Transaction Name profiles and adding them to this list. 


Defining CPI-C Side Information 
Some applications, ike APING, do not require CPI-C side information. These 
applications use programming calls available on a particular platform to dynamically 
create side information when running. SNA Services/6000 provides the program- 
ming calls that allow APING (and other applications) to do this dynamic definition, 
so you do not need to create this Side Information profile for APING. For those 
applications that require CPI-C Side Information, this is how to create a profile: 


From within SMIT, CPI-C Side Information panel can be accessed by following 
this senes of panels: 


--Logica] Units 
--LU6.2 
--LU6.2 CP] Communications Side Information 


The following figure shows the CPIC-C Side Information panel. Replace the 


svmbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. 


CPI Communications Side Information 


PROFILE name = 2SYMDEST? 
PARTNER LU name = 2?CALLCONNPRO? 
REMOTE TRANSACTION PROGRAM name = ?TPNAME? 
SERVICE transaction program? = no 

MODE name = 2?HODE? 


Figure 13. CPI Communications Side Information 
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Configure to run as a server 


Define local transaction programs 


To run AIX as a server, you must define the transaction programs (TPs) on your 
machine with which a client can start a conversation. For each TP, you must 
define a TP profile, and then you need to create a TP Name List profile that lists 
the TP profiles you have defined. This TP Name List profile will then be refer- 
enced in the definition of a connection. (If you will not be running this machine as 
a server, you do not need to create either the Transaction Program Name profile or 
the Transaction Program Name List profile.) 


Create Transaction Program Name 


From within SMIT, the Transaction Program Name profile panel can be accessed 
by following this series of panels: 


--Logical Units 
--LU6.2 | 
--LU6.2 Transaction Program Name 


The following figure shows the Transaction Program Name profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. You'll also need to change any 
other values that are highhghted. | 


PROFILE name = 2TPNAMEPRO? 
Transaction program name is in HEXADECIMAL? = no 
TRANSACTION program name = 2?TPHAME? 

PIP data? = no 

SUBFIELDS = 0 
CONVERSATION type = mapped 
RECOVERY level = no_reconnect 
SYHC level = confirm 

Full PATH to TPH executable = 2?TPPATH? 
HULTIPLE INSTANCES supported? = yes 

User ID = 100 

SERVER synonym name = TDEFAULT 
RESTART action = once 
COMMUNICATION type = signals 

IPC queue key = 0 

Standard INPUT file/device = {dev/null 
Standard OUTPUT file/device = /dev/console 
Standard ERROR file/device = /dev/console 
SECURITY Required = none 
communication_ipc_queue_key = 0 


RESOURCE SECURITY ACCESS LIST profile = RSRCDEFAULT 


Figure 14. TP Name profile 


Create Transaction Program Name List 
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From within SMIT, the TP Name List profile panel can be accessed by following 
this senes of panels: 


--Logical Units 
--LU6.2 
--LU6.2 Transaction Program Name List 


The following figure shows the LISTEN Logical Connection profile panel. Replace 
the symbols (the words beginning and ending with question marks) with the corre- 
sponding values from the Configuration Worksheet. 
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Running APING 


How to find... 


TP Name List 
PROFILE name =- ?TPHLISTPRO? 


Hame 1 2TPHAHE PRO? 


Figure 15. Transaction Program Name List 


Note: You can define more Transaction Programs to be run between two machines 
by adding more TP Name profiles and adding them to this TP Name List. 


Execute APING to contact the partner LU defined by the outgoing connection, 
°CALLCONNPRO?, by typing: 


aping -n ?CALLCONNPRO? 


with the APING executable being located in a directory in the system’s PATH (ex. 
jlocal/appctps). 


You can also specify the CPI-C symbolic destination name: 


aping -n ?SYHDEST? 


Once an incoming session is established, the RS ‘6000 can communicate with this 
caller only on this session (and not on a new outgoing call). This problem will be 
fixed in a later release. Thus, if an incoming session 1s already established, you 
would not specify °>CALLCONNPRO? as the target. You would specify the listen 
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connection, 7LISTCONNPRO?. 


¢ LU name 


The LU name 1s specified in a Local LU6.2 profile as the “Local LU NAME” 
parameter. To find out which Local LU6.2 profile to look at, see the listen 
Logical Connection profile parameter “LOCAL LU profile name”. There may 
be many Logical Connection profiles. The one to use 1s the one that specifies 
as its “ATTACHMENT profile name” the same Token nng Attachment profile 
used in the startsre command that starts the listen attachment. 


For example: In the configuration recommended above, the Token Ring 
Attachment profile specified in the startsre command is LISTEN. The Logical 
Connection profile that specifies LISTEN as its “ATTACHMENT profile 
name” is called 7>CALLCONNPRO?. The “LOCAL LU profile name” in the 
?CALLCONNPRO? Logical Connection profile is 7_LUPRO? Therefore, the 
LU name 1s the value specified as the “Local LLU NAME” parameter of the 
?LUPRO? Local LU6.2 profile. 


¢ Network name 


See the discussion for how to find the local LU name. The Network name js 
also specified in the Local LU6.2 profile, as the “NETWORK name” parameter. 


¢« Control Point (CP) name 
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The CP name is specified in the Control Point profile as the “CONTROL 
POINT name.” The actual Control Point profile being used is specified in the 
Attachment profiles as the “CONTROL POINT profile name.” | 


e LAN address 


The LAN address is hard-coded on the Token-Ring adapter in the AIX 
machine or 1s over-ndden by a value called the “locally administered LAN 
address. It is a 12-digit hexadecimal value. You can find the LAN address by 
running the command Iscfg -v. The LAN address is specified by the Network 
Address parameter under the tok0 resource. This parameter will specify the 
locally administered address if there 1s one. 
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AS/400 Configuration 


Prerequisites 


Terminology 


This chapter descnbes configuration for APPC on the AS/400. The chapter uses a 
step-by-step methodology to descnbe how to configure APPC communications on 
the AS 400 with an IBM token-nng adapter connection to the network. 


APPC/APPN support is part of the OS/400 operating system of AS/400. 


For more information refer to the following publications: 
¢ AS;400 Programming Reference Summary-ecit, SC2/-8076 
¢ AS/400 Programming: Control] Language Reference:cit, SC41-0030 
¢ AS'400 Communications APPC Guide-ecit, SC41-8189 
¢ AS-°400 Communications APPN Guide:ecit, SC41-8188 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by the AS‘400. 


Network Name Remote Network Identifier 


AS/400 APPC Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by referring to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (?), the middle column descnbes 
what the vanable is used for and how to determine the value, and the nght-most 
column is for you to fill in with a value. Whenever there 1s a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
nght column. 


For example, if you are following our excellent recommendations, you will write 
#/\TER in the nght column on the 7MODE? line. Then in Figure 21 on page 32 
you will type #INTER on the AS/400 screen that looks like this: 


HOdename ==> #INTER 
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Hlow to determine the value for this symbol Fillin value | 
| | here 


Values that much match with other places 


?7LUNAME? 


This is the symbol that refers to the LU name of the machine 
you are defining to the network. 1 to 8 character field consisting 
of alphanumeric characters which is the LU name of the node. 
Choose a name that is unique within the same network name. 
Refer to “How do I Configure a Network?” on page 7 for more 
information about LU names. 


2?CPNAME? 


This is the symbol that refers to the Control Point name of your 
machine. It should be the same as your 7 LUNAME?. Refer to 
“What Is APPN?” on page 6 for more information about 

control points. | 


INETWORK? This is the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting of alphanumenic characters. There is a structured 
format for the network name which includes the country code, 
enterpnise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to “How do I Configure a Network?” on page 7 for more 


information about network names. 


?PARTNERLU? This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. Refer to “How do I Configure a Network?” on page 7 


for more information about the partner LU name. 


2?PARTNERCP? This is the Control Point(CP) name of your partner. Refer to 
the “How to find..” section of the partner computer’s configura- 


tion chapter for this value. 


27PARTNERNET? | This 1s the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s “How 
to find...” section. Refer to “How do I Configure a Network?” 
on page 7 for more information about the partner network 


name. 


29LANADDRESS? | This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link is 

being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 


value. 


TT PNAME? 


This is the. symbol for the Transaction Program name. This 1s 
the name of the transaction program at the partner computer. 
For APING, the TP Name on the server is APINGD. 


This is the symbol for the mode name. See “What Is a Mode?” 
on page 5 for a discussion of modes. Often, a client/server pro- 
duct’s documentation specifies what mode must be used by that 
product. APING can use any mode (this can be specified on the 
APING command line), but the default is #INTER. It 1s recom- 
mended that you use one of the architected modes discussed in 

the “What Is a Mode?” section. 


IMODE? 
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, 


Symbol How to determine the value for this symbol Fill in value 
here 


°NODEID? This 1s the symbol for the node identifier. Refer to “ What is a —_ 


Node Identifier?” on page 7 for information on whether or not 
you need this value, and if so, how to define it. If you do use 
the node identification, the recommended/?/required IDBLOCK 
value (the first part of the node ID) on this platform is 05D. 


Local values 


27?CONTRNAME? 


This is the symbol for the controller description name. | to 10 
letters or numbers which will be used as a local name on the 
AS 400 machine to refer to the controller description. You can 
choose any name you like, but since you will use this name later 
to refer to this controller, choose a meaningful name (such as 
PARTNERCP). 


2?DEVNAME? This is the symbol for the device description name. 1 to 10 
letters or numbers which will be used as a local name on the 
AS.400 machine to refer to the device description. You can 
choose any name you like, but choose a meaningful name (such 


as PARTNERCP0O0) 


This is the symbol for your AS/400’s APPN node type. This 
can be *ENDNODE to be configured as an end node, or 
*NETNODE to be configured as a network node. 


°LINENAME? This is the symbol for the line description name. | to 10 letters 
or numbers which wul be used as a local name on the AS/400 
machine to refer to the line descnption. You can choose any 
name you like, but since you will use this name later to refer to 
this controller, choose a meaningful name (such as TRLANXX, 
Where XX 1s the LAN adapter number) 


This is the symbol for the resource name. You can use the 
command “WRKIIDWRSC” to find out the resource name of 
the adapter you are using. 

WRKHDWRSC TYPE (*CMN) 


?NODETYPE? 


7RESNAMIE? 


2PLUALIAS? This is the symbol for the partner LU alias. | to 8 characters 
that designates a nickname for the Partner LU. Alias names are 


case sensitive. (Suggestion: PARTNERLU) 


This is the symbol for the CPI-C side information symbolic des- 
tination name. It is any 1-8 character name you choose. It will 
be used locally on the AS’400 machine to refer to a CPI-C side 

information entry. (Suggestion: PLUALIAS) 


SY MDEST? 


Working with the AS/400 


AS 400 Configuration 27 


Starting/stopping APPC | 
| You can start and stop an APPC controller using the Vary Configuration 
(VWRYCFG) command. | 


The VRYCFG command can be used to activate and deactivate a controller, or 
link. To activate or start a link between two systems type the following from the 
command entry (CL commands): 


VRYCFG CFGOBJ(2CONTRNAME?) CFGTYPE(*CTL) STATUS(*ON) 


To stop a link type the following from the command entry: 


VRYCFG CFGOBJ(?CONTRNAME?) CFGTYPE(*CTL) STATUS(*OFF) 


To activate or start a link between two systems using menu commands, follow this 
sequence: | | 


— -- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 1. Configure devices and communication 
-- 2. Configure communications and remote hardware 

-- 1. Work with communications controllers 

-- 8. next to desired ?CONTRNAME? entry. 

-- l. or 2. for Vary on or Vary off 


Other Commands | 
¢ APING.DOC - Refer to the APING documentation for how to compile the 
APING and other progarms on the AS/400. 


Configuration 
Working with APPC configuration 


The following configuration steps will be discussed: 
]. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to mun as a client 
a. Define CPI-C side information 
b. Other chent configuration 


4. Configure to run as a server 
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a. Define transaction programs 


b. Other server configuration 


When using AS ‘400 APPC configuration commands, you can enter the commands 
in one of three ways: 


¢ Using the command prompt: Enter the command and press PF4(Prompt). 


¢ Using direct entry: Enter the command and its parameters following the syntax 
described in the CL Reference 


¢ Proceeding through a series of menu driven panels. 
Define yourself to the network 


1. To communicate within an APPN network you must have an LU name. 
Dunng the AS/400 installation process, at least one LU name was configured. 
Your local LU 1s displayed on the Display Network Attnbutes panel. You can 
view this display either by using the DSPNETA command, or by follwing this 
sequence of panels: 


-- AS/400 Main panel 
-- /. Define or change the system 
-- ]. Configuration 
-- 4, Network management 
-- 1. Display network attributes 


System: LUNAME 


Current system name 

Pending system name 

Local network ID 2HETWORK? 
Local contro] point name ?CPHANME? 


Default local location ?LUNAME ? 
Default mode BLANK 
APPH node type 2NODETYPE? 
Haximum number of intermediate sessions 

Route addition resistance 


Figure 16. DISPLAY NETWORK ATTRIBUTES. This screen displays the configured 
network attributes. 


If you wish to change the network attnbutes, use the command CHGNETA 
command or follow this panel sequence: 


-- AS/400 Main panel 
-- 7. Define or change the system 
-- 1. Configuration 
-- 4, Network management 
-- 2. Change network attributes 
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2. For APPC on the AS/400, an entry called a communications entry must be 
created in a subsystem to handle APPC program evoke (or allocate) requests. 
To check to see if the communications entry has already been defined: 


a. Type WRKSBS 

b. Type 5 in the blank next to your communications subsystem (ex. QCMN) 
c. Type 8 to view Communications Entries - 
If there is not a Communications Entry for device APPC, you must add one. 


To add a Communications Entry for device APPC, type the CL command 
ADDCMNE: 


ADDCHNE 
Subsystem Description 
Library 


Remote Location 


Job Description > QDFTJOBD 
Library 
Default User Profile > QUSER 
> *ANY 


> *NOHAX 


Figure 17. ADD COMMUNICATIONS ENTRY. This screen displays the Add Commu- 
nications entry parameters. 


The subsystem must be stopped and restarted for the communications entry to 
be active. 


Define a link to a partner or network node 
There are three ‘descriptions’ used for APPC communications on the AS/400. 
These are: : 


¢ Line Description 


The line descnption describes the physical line connection to be used between 
the AS ‘400 and the network. 


¢ Controller Descnption 


The controller description is used to descnbe all the charactenstics of a link to 
an adjacent computer. 


e Device Descnption 
The device description is used to describe all the characteristics of the logical 


connection between two locations 1n the network. 


The AS/400 has a feature called automatic configuration. Automatic configuration 
can be used to autocreate a device descnption and/or a controller descnption on the 
AS 400. The autocreate happens when a partner tries to start a conversation with 
the AS’400. To ‘tum on’ automatic configuration, type the CL command 
WRKSYSVAL and follow these steps: 


1. Page down until you find the system value, ‘QAUTOCFG’. 
2. Type 2 for Change 
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3. Type 1 to ‘turn’ on automatic configuration 


The below configuration directions describe how to create or change line, controller, 
and device descnptions. If you wish to autocreate a controller andor device 
descnption, you can skip those respective steps. 


1. Create or change line description: You must have a line description to be used 
with the controller descnption. If there is a line description already available, 
you should not create a new one and can skip this step. This example creates a 
token nng line descnption named TRLAN. To create or change line 
descnptions for token-nng, use CRTLINTRN or CHGLINTRN (create or 
change T-R line). | 


CRTILINXXX 


Line Description 
Resource name 
Online at IPL 
Vary on wait 


?LINENAME ? 
2RESHAME ? 
AYES 
*NOWAIT 


Maximum contollers 
Line speed 

Haximum frame size 
Local adapter address 


Figure 18. CREATE CHANGE LINE DESCRIPTION. This screen displays the Line 
Description attributes. 


2. Create or change controller descnption (link definition): You can access con- 
troller descnptions through the CRTCTLAPPC or CHGCTLAPPC commands 


(Create’Change Controller Descnption, APPC). The following example shows 
only the fields of the controller descnption that need to be changed. You can 


allow the other fields to default. 


CRICTLAPPC 
Controller Description 
Link type 
Online at IPL 
APPli-capable 
Switched line list 


Remote network identifier 
Remote contro} point 

LAH remote adapter address 
APPH CP session support 

APPN node type 

APPH transmission group number 


2CONTRHAHE ? 
*LAN 

BYES: 

*YES 
?LINENAHME ? 
?PARTNERNET ? 
2?PARTNERLU? 
2LANADDRESS? 
*YES 

*CALC 


Figure 19. CREATE, CHANGE CONTROLLER DESCRIPTION. This screen displays 
the Controller Description attributes. 


3. Create or change device description (LU definition): You can access controller 
descnptions through the CRTDEVAPPC or CHGDEVAPPC commands 
(Create,Change Device Descnption, APPC). The following example shows 
only the fields of the device description that need to be changed. You can allow 


the other fields to default. 
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CRTIDEVAPPC 


Device Description ?DEVNAME ? 
Remote Location ?PARTHERLU? 


Local Location ?LUNAHE ? 
Remote network identifier ?PARTHERNET ? 
Attached Controller 2CONTRNAME? 


Figure 20. CREATE-CHANGE DEVICE DESCRIPTION. This screen displays the 


Device Description attributes. 


Configure to run as a client 


Define CPI-C side information | 
To use a CPI-C symbolic destination name, a CPI-C side info entry or CSI should 
be defined. 


The following are CL commands that allow you to create, display, print, change, 
delete and work with the side information. 


CRTCSI- Create the *CSI 

DSPCSI - Display or print the *CSI object 

CIIGCSI - Change the *CSI object 

DLTCSI - Delete the *CSI object 

WRKCSI - Provides a menu interface for the *CSI object 


CRICSI 

Side Information 2SYMDEST? 
Library 

Remote Location ?PARTHERLU? 


2T PANE? 
2MODE? 


Figure 21. CREATE CPI-C SIDE INFORMATION. This screen displays the CPI-C Side 


Information parameters. Press PF 10 for Additonal parameters. 


Configure to run as a server 


Define transaction programs 

To run AS’400 as a server, you must, in addition to the configuration steps above, 
define a transaction program (TP) on your machine which will be started when the 
chent establishes a conversation. 
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To define the TP for AS/400, the User Library List needs to be changed. The 
library where your transaction program resides should be added to the list. To 
access the User Library List do the following: 


¢ Type the WRKSYSVAL from a command line 
¢ Page down until you find the QUSRLIBL system value. 
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¢ Select 2 for Change 


¢ Type your server program’s library name (e.g. APING) in the space next to the 
desired sequence number. The library should contain the server program to be 
started (e.g. APINGD) 


Running APING 


You should now be able to APING any of the computers you configured to using 
the steps above. 


To run APING, from the AS’400 command line, type the CL command CALL 
from the command entry line. 


Call Program (CALL) 


Program 

Library 

Parameter > ?PARTNERLU?2or 2SYMDEST ? 
or ?PLUALIAS? 


Figure 22. CALL program. This screen displays the Call program parameters. 


How fo find.... 
« [LU name 


During the AS ‘400 installation process, at least one LU name was configured. 
Your LU name can be found on the Display Network Attnbutes panel. Use 
DSPNETA command or follow this panel sequence. 


-- AS/400 Main panel 
-- /. Define or change the system 
-- 1. Configuration 
-- 4, Network management 
-- 1. Display network attributes 


On the Display network attributes panel, the LU name is the Default local 
location. 


« CP name 


On the Display network attributes panel, the CP name 1s the Local control 
point name. 


¢ Network Name 


On the Display network attributes panel, the Network Name 1s the Local 
network ID. 


¢ LAN address 
the LAN address is found by accessing the line description. 
— Type WRKLIND (Work with line descnptions) 


— Page down to the Token-Ring line description entry 
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— Type “5S” in front of the Token-Ring line description entry to Display © 


— Look im the panel entry for Local Adapter Address. This is the value that a 
partner wil enter for its remote address when connecting. 
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CICS Configuration 


Prerequisites 


Terminology 


The Customer Information and Control System (CICS) provides.an environment 
optimized for running very short programs called transactions on System ‘370 and 
System/390 processors. Transactions consist of a program (that may perhaps call 
other programs) with an associated transaction identifier or transaction [1D The 
transaction ID 1s 1-4 characters long but typically is always four characters. For 
example, the transaction CEDA starts the program that performs on-line resource 
definition. 


This chapter describes how to configure CICS to use the APING and APINGD 
sample programs. | 


The following software levels are required for the definitions in this chapter: 

« CICS; ESA Version 3 Release 3 

¢ ACF/VTAM Version 3 Release 4.1 or Version 3 Release 3 

¢ MVS;ESA Version 4 Release 3 or Version 4 Release 2 

¢ NCP Version 5 Release 2 or later 
In most cases, you will find CICS has already been installed and an LU name has 
been assigned. In addition, you will almost certainly find VITAM installed and the 
network name has already been defined. Therefore, while we give instructions on 
how to set the LU name in CICS and VTAM, you probably will not need to make 


any changes. The information 1s very useful, however, because you will need it to 
configure other platforms that wish to communicate with CICS. 


In addition, you should have the APING and APINGD sample programs for CICS. 
These publications provide detailed information on the configuration process for 
CICS Version 3 Release 3 and VTAM Version 3 Release 4.1. 

¢ CICS/ESA: Resource Definition (Online), SC33-0666 

© CICS-ESA: System Definition Guide, SC33-0664 

¢ VTANM: Resource Definition Reference, SC31-6438 

¢ VTAM: Network Implementation Guide, SC31-6434 

« NCP: Resource Definition Reference, SC30-3448 


Below is a table of standard APPC terms and the equivalent CICS terms. Using. 
standard terms makes configuring two unlike platforms easier so standard terms are 
used whenever possible. Some terms have no CICS equivalent but instead are set in 
VTAM or NCP. 
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[Standard Term «dS Term 
[ink Name *d PC ame TAM) 


LAN Address | LOCADD (NCP) 
Adjacent LAN Address DIALNO (VTAM) 


Note: CICS uses network name only when defining CPI-C side information. 
VTAM keeps track of partner LUs and routing traffic to the partner LUs, in the 
same network or different networks. | 


CICS Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by refernng to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a vanable 
name that starts and ends with a question mark (?), the middle column describes 
what the variable 1s used for and how to determine the value, and the nght-most 
column is for you to fill in with a value. Whenever there is a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
nght column. 


For example, if you are following our excellent recommendations, you will wnite 
#I1NTER in the nght column on the 7A/ODE? line. Then in Figure 30 on page 48 
you will type INTER on the CICS screen that looks lke this: 


MOdename ==> #INTER 
Likewise, in Figure 27 on page 45 the substitution would look lke this: 


?7PARTNERLU? LU LOCADDR=0,ISTATUS=ACTIVE, X 
MODETAB=?HMODETABLE? , DLOGHOD=#INTER 


How to determine the value for this symbol Fill in value 
here 


Values that must match in other places 


2LUNAME? This is the LU name of the CICS region you are configunng. It 
can be 1-8 characters (letters or numbers) but must begin with a 
letter. In CICS this is called the APPLID; in VTAM this is 
called the APPLID or ACBNAME. Reter to “How do I Con- 
figure a Network?” on page 7 for information on how to define 
this value. If CICS is installed and running, you will not be able 
to choose this, you will have to get this value from the CICS or 


VTAM system programmer. 


This 1s the network name, called the NET/D in VITAM. It can 
be 1-8 characters (letters or numbers) but must begin with a 

letter. CICS uses the value defined in VTAM. See “How to 
find...” on page 55 for information on how to find this value. 


INETWORK? 
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How to determine the value for this symbol Fill in value 
here 


?CPNAME? 


27PARTNERCP? 


?PARTNERLU? 


27PARTNERNET? 


27LANADDRESS? 


7PFPNAME? 


2SERVERTRAN? 


2MODE? 


This is the Control Point name of your machine. It can be 1-8 
characters (letters or numbers) but must begin with a letter. It’s 
value is set in VIAM, where 1t 1s called the SSCPNAME. See 

‘How to find...” on page 55 for more details. 


This is the Control] Point name of the partner computer. 
VTAM uses this name in the CPNAME parameter to identify 

partner computers. Refer to the “How to find...” section of the 
partner computer’s configuration chapter for this value. 


This 1s the partner's LU name. CICS calls this the netname. 
This is NOT the same as the ?NETWORK? name described 
earlier. Refer to the “How to find...” section of the partner com- 
puter’s configuration chapter for this value. In many cases this 
value will be the same as the preceding value (7PARTNERCP?).- 


This is the network name of the partner computer. WIAM does 
all processing of network name Use the network name from the 
partner computer's “How to find...” section. If this value is dif- 
ferent than the value for 7?NETWORK?, special coding is 
required in VWI AM (see Figure 28 on page 45 for an example). 


This is the LAN address of the network processor that connects 
the host to the LAN. It is 12 hexadecimal digits (for example, 
x’ 1000SA25EEF0’ or x’400085950001’). This chapter assumes 
that the network processor is an IBM 3745 running NCP V5R2 
or later. 


VTAM/’s preferred method for connecting to APPN or LEN 
nodes requires the partner computer to initiate the connection. 
This relieves VWT.AM (and VITAM system programmers) from 
having to know the LAN Address of the partner computer. 
VTAM uses the 7PARTNERCP? name to identify the partner. 


This is the Transaction Program name. It is the name that 1s 
sent across the network to the server machine and can be 1-64 
characters. including a period (.). The server machine then maps 
this TP Name to an executable program. The TP Name is 
usually specified in a client/server product’s documentation. For 
APING, the default TP Name is APINGD but this can be 
changed. 


A 4 character name for the CICS server transaction, that 1s, the 
transaction initiated by an APPC partner LU. This must match 
the first four characters of the Transaction Program name and 

must be in upper-case. 


See “What Is a Mode?” on page 5 for a discussion of modes. 
Sometimes a client/server product’s documentation specifies what 
mode must be used by that product. APING can use any mode 
(this can be specified on the APING command line), but the 
default 1s #INTER. 


Local values 
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* 


Variable How to determine the value for this symbol Fill in value 
: here 

2LINKNAME? 1 to 8 letters or numbers which will be used as a local name to 

refer to the link to a partner computer. You can choose any 

name you like, but since you will use this name later to refer to 

this link, choose a meaningful name. CICS relies on VIAM to 

handle this type of information. VIAM calls the link name the 

PU name and it must begin with an alphabetic character. See -- 

Heading ‘CPLNKF’ unknown -- for more information. 


2SYMDEST? This 1s the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. CICS does not pequite 


you to create side information. Example: JOE. 


Profile names, file names - these are names of CICS resources or members of MVS datasets. Unless 
otherwise noted, you can choose any name you want. 


?PROCLIB? 


The dataset that contains the CICS start-up procedure. This 
procedure library should already exist and will probably have a 
member for CICS. Examples: SYS1.PROCLIB or 

IPO1!.PROCLIB. 


The procedure name (a member in ?PROCLIB?) that starts 
CICS. This job must run after the VTAM application node 
(APPL) ts active. Example: CICS330. 


The dataset with just those CICS System Initialization Table 
(SIT) parameters that are set at start-up tme. There are several 
dozen SIT parameters. If several CICS regions have the same 
settings for most of them, they can use the same pre-assembled 
table but change the ones that need to be unique (like the LU 
name) when starting CICS. One way to do this is with a dataset 
containing the parameters to be changed. Example: 
CICS330.SYSIN(DFHSSIP 1). 


The VIAM switched major node containing the PU definition 
for the remote penpheral node (if the partner LU 1s in a DOS, 
OS/2, AIX, or OS’400 or other APPN platform). WITAM 
V3R4, the basis for the examples in this book, has a feature that 
dynamically creates the PU definition. This may already be 
defined. Example: LANSW. 


The VTAM application major node with the CICS APPL state- 
ment. This must be varied active before starting CICS. This 
typically will already exist so contact your VITAM systems pro- 
grammer for this. If you are looking on your own, it will usually 
have APPL in the name. Example: CICSAPPL. 


A 1-8 character name for the collection of CICS definitions. 
CICS reserves for its own use names beginning with DFH. You 
can choose any name. Examples: OS2 or AIX. 


?CICSPROC? 


2STTPARMS? 


ISWNETNODE? 


2?APPLNODE? 


2?GROUP? 


A 1-4 character connection name used as a nickname for the 
partner LU. The CICS connection defines the partner LU. 
Several other parameters are tied to the connection name. It 
does not have to match anything outside CICS. Example: 
DWAI. 
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How to determine the value for this symbol Fill in value 
| here 


°SESSION? A 1-8 character name for the sessions with a given mode name. 


ICLIENTTRAN? 


A 1-4 character name for the CICS client transaction, that is, a 
transaction started by a terminal user signed on to this CICS 
region. Example: APNG. 


A 1-8 character name for the chent program. This typically is 
the same as the real program name and this chapter will use that 
convention. Example: APING. 


?CLIENTPGM? 


A 1-8 character name for the server program. This typically is 
the same as the real program name and this chapter will use that 
convention. Example: APINGD. 


2SERVERPGM? 


?PROFILE? A 1-8 character name for the partner characteristics in CICS’ 
CPI-C side information. See “Define CPI-C Side Information 


(OPTIONAL)” on page 51. 


The load library containing the compiled and link-edited pro- 
grams for APING and APINGD. Example: 
CICSAPPS.LOADLIB. 


The binary table containing mode names that VITAM searches, 
usually a member of SYS1.WTAMLIB. This may already exist 
but may not have the preferred mode names (#INTER, 

#BATCH, etc.) Check to make sure. Example: APPCMODE. 


27APINGLIB? 


?MODETABLE? 


Working with CICS and VTAM 


This section descnbes commands that you (or an MVS system operator) must issue 
from an MVS operator console to make CICS and VTAM work. There are pro- 
grams like the JES Spool Display and Search Facility (SDSF) that allow authonzed 
users to view the system log and enter {VS commands from any 3270 session. If 
you have such a program then you don't have to be at the System 390 console to 
issue these commands. 


VTAM definitions are grouped into major nodes, each of which is a separate 
member of SYS]. VFAMLST. The VBUILD TYPE= statement determines the 
type of major node. The two types you will use are application major nodes and 
switched major nodes. Application major nodes define host LUs using APPL state- 
ments, While switched major nodes define peripheral nodes using PU statements and 
LU statements. All of these will be descnbed in more detail. 


Starting/stopping APPC 
APPC 1s part of CICS; it starts automatically when CICS 1s started, and stops auto- 
matically when CICS is stopped. Starting CICS consists of two steps: 


1. Starting the VT AM application major node that contains the CICS APPL defi- 
nition. |o do this, issue the following command from the MVS operator 
console: 


v net,act,1d=?APPLNODE? 
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Other commands 
Other MVS and CICS commands that are necessary or just useful include the fol- 


lowing: 


2. Running an MVS job that starts CICS. This job (called a procedure or proc) is 


usually in a procedure library such as SYS1.PROCLIB. To start CICS, issue 
following command from the MVS console: 


s ?CICSPROC? 


The procedure can be included in the MVS start-up list or a system operator can 
run it from the console. For more details on the start-up proc, see “Defining your- 
self to the network” on page 41. 


MVS console commands 


¢ Ifthe partner LU 1s in a computer connected to an NCP (a common case for 


CICS), the VTAM definition for the partner computer must be active before the 
computer can even connect to NCP. (There are some exceptions to this. See 
VTAM: Network Implementation Guide, Chapter 5, Section 2 for more details.) 
In VTAM, a switched major node is a set of definitions for partner computers 
on a LAN (in this example). The following command activates the switched 
major node and all the partner computer definitions in it: 


v net,act, id=?SWNETNODE? 


If the major node 1s active the following commands deactivate and activate the 


link to the partner computer: 


v net,inact, id=?LINKNAME?, f 
v net,act,id=?LINKNAME? 


Displaying an active LU shows all the sessions and session partners of that LU. 
The following commands display the CICS LU and the partner LU. 


d net, id=?LUNAME?,e 
d net, id=?PARTNERLU? ,e. 


CICS Commands | 
¢ In CICS, the CEMT transaction allows you to display and modify the status of 


connections, netnames, and modenames (that 1s, all sessions with a particular 
mode name): 


cemt ing conn(?CON?) 
cemt ing netname (?PARTNERLU? ) 
cemt ing netname(?HODE?) 


Configuration 


This guide provides instructions for using CICS Resource Definition Online (RDO) 
to create and modify CICS definitions. To start Resource Definition Online, you 
must be logged on to CICS and your user-ID must be authonzed to run the CEDA 
transaction. 


40 = Multi-platform APPC Configuration Guide 


Working with APPC configuration 


The following configuration steps will be discussed: 


1. Define yourself to the network 


bo 


. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


Since CICS’ pnmary role 1s as a server, the server discussion will come before the 
chent discussion. 


Defining yourself to the network 
Typically, the LU name for CICS has already been defined by the CICS systems 
programmer. If you are logged on to CICS, for example, the CICS LL name 
appears in the lower nght corner of the 3270 screen. If this is the case for you, skip 
directly to “Define a link to a partner or intermediate node” on page 44. 


If you must start from scratch, this section descnbes how to create the CICS LU 
name. The APPLID parameter in the CICS System Initialization Table (SIT) 
determines the LU name for CICS. This macro statements are assembled and link- 
edited into a binary table that CICS loads at start-up trme. The APPLID must 
match the ACBNAME used in the VTAM APPL statement. 


The APPLID in the System Initialization Table can be over-ndden at start time by 
including some statements in the start-up procedure. In particular, the APPLID 
can be (and usually is) specified this way. Figure 23 on page 421s a CICS start-up 
procedure. The dataset with the over-nde parameters must be in the SYSIN DD 
concatenation list. 


The highlighted sections are discussed in the notes below. This is not the complete 
listing, just the section from the beginning down to the DFHRPL DD statement. 
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/ /DFHSTART PROC START='AUTO', 
// INDEX1='CICS330'," 
// INDEX2='CICS330', 
// REGNAHI=, 
// REGNAM2=, 
// REG='32M', 
// DUMPTR="YES', 
// RUNCICS='YES', 
J] -OUTIC=**" , 
// RDRC='A', 
// SIP=1 
etc. 


YP fO Ore R ee are eo Le ee N TE ae ee By ee STS one ee ee nee 
VL enn eG Berea, EXECUTE CICS KKEKKKEKKEKKEKKEKKKKKKKENR 


RKEKKKRKEKKEKKREKEKKEKKKKKEKKEKEKKEKEKKREEKEKERKEREKKEEKEKEKEKEEKKEKKAESE 


//CICS EXEC PGM=DFHSIP, REGION-&REG, TIME=1440, 
// COND=(1,NE,CICSCNTL), 

// PARH="START=&START, SYSIN' 
his 
//* THE CAVM DATASETS - XRF 
//OFHXRMSG DD DISP=SHR, 
// OSN=&INDEX1..CNTL.CICS&REGNAM]. . DFHXRMSG 
//OFHXRCTL DD DISP=SHR, ; 
// DSN=&INDEX1..CNTL.CICS&REGNAM1. .DFHXRCTL 

//* THE "FILEA" APPLICATIONS SAMPLE VSAM FILE 
//* (THE FILEA DD STATEMENT BELOW WILL 
//* OVERRIDE THE CSD DEFINITION IN GROUP DFHMROFD) 
//FILEA DD DISP=SHR, 
// OSN=8INDEX1..CICS&REGNAM1. .FILEA 

fF 
//SYSIN DD DSN=?SITPARMS? , DISP=SHR 
//OFHCHACD DD DSN=C1CS330.DFHCMACD, DISP=SHR 


if THE CICS STEPLIB CONCATENATION 
//STEPLIB DD DSN=EDC.V2RIMO.SEDCLINK,DISP=SHR 
// DD DSN=&INDEX2. .SDFHAUTH,DISP=SHR 
// DD DSN=SYS1.COB2CICS,DISP=SHR 
fy DD DSN=SYS1.COB2LIB,DISP=SHR 
8 ba DD DSN=INS.RESLIB,DISP=SHR 
ff THE CICS LIBRARY (DFHRPL) CONCATENATION 
//DFHRPL DD DSN=EDC.V2R1MO.SEDCLINK,DISP=SHR 
// DD DSN=&INDEX2..SDFHLOAD,DISP=SHR 
// DD DSN=?APINGLIB? ,DISP=SHR 
I] DD DSN=SYS1.COB2CICS,DISP=SHR 
// DD DSN=SYS1.COB2LIB,DISP=SHR 

etc. 


Figure 23. Startup Procedure for CICS - 7?PROCLIB??CICSPROC?) 


Notes: 


# note 1 


# note 2 


# note 2 


1. The ?SITPAR MS? dataset contains the overndes to the System Initialization 


Table. This file must be in the SYSIN DD lst. 


2. The DFHRPL DD concatenation list is where CICS looks for executable pro- 
erams and must contain the load library containing the APING and APINGD 


modules. In this example, the load library is PAPINGLIB?. 
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Figure 24 on page 43 shows a data set with SIT over-nde parameters, in particular 
the APPLID. Once CICS has started, these parameters become part of the SIT for 
this CICS region. 


SIT=68, 
XRF=NO, 

SEC=YES, 
XAPPC=YES , 
XCMD=NO, 
XDCT=NO, 
XICT=NO, 
XPCT=NO, 
XPPT=NO, 
XTST=NO, 
XTRAN=YES, 
XFCT=NO, 
XPSB=NO, 
AUXTR=ON, 
AUXTRSW=NEXT, 
APPLID=(?LUNAME?),  # note 
ISC=YES, 
GRPLIST=MNFLIST, 


END 


Figure 24. CICS SIT Override Parameters - CICS330.SYSIN(DFHSSIP1) 


Note: The APPLID must match the VTAM ACBNAME parameter. 


To define the CICS LU name in V 1AM, you wul need to set up an application 
major node with a minor node for this CICS region. In VTAM, the name of a 
resource (LU, APPL, etc.) 1s the name that precedes the key word in the definition. 
Figure 25 shows an example of a VTAM application major node with one minor 
node (that is, one APPL statement). 


2APPLNODE? VBUILD TYPE=APPL # note 1 
?LUNANE? APPL ACBNAME=?LUNAME? , AUTH=(ACQ, PASS, VPACE) , X  # notes 2,3,4 
HODETAB=2MODETABLE? , EAS=200, PARSESS=YES, VPACING=0, X  # notes 5,6 


SONSCIP=YES 


Figure 25. VWPANI Application Major Node - SYS].VTANILSTCAPPLNODE?) 


Notes: 


l. 


tl 


By convention, the major node name (the label on the VBUILD statement) is 
also the name of the member in SYSI.VTAMLST. 


. The ACBNAME must match the APPLID parameter in the CICS System 


Initialization Table. If the ACBNAME is not specified, it defaults to the name 
directly preceding the APPL keyword (?7LUNAME? in this figure). 


. The mode table ?4{10DETABLE? must contain the mode names used by 


partner LUs that initiate connections to this CICS. VIAM only checks the 
name (the parameters can be anything or nothing). WIAM does not check out- 
bound BINDs for mode names, only inbound BINDs. So you may mn into a 
situation where you can acquire a session from CICS successfully but a CNOS 
from a remote system will fail. 


. The continuation character (X in this example) must be in column 72, and con- 


tinuation lines (here the MODETAB =...) must begin in column 16. 
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Define a link to a 


5. PARSESS = YES indicates this CICS will use parallel sessions. 


6. Another parameter, APPC, is not coded here because the default, APPC = NO, 
is the desired value. CICS uses its own APPC implementation and does not 
use VIP AM's APPC support. 


There are two mode names that must be in the mode table (? MODETABLE?) 
named in Figure 25 on page 43. They are SNASVCMG and ?7MODE? (the mode 
name from the worksheet in “CICS Configuration Worksheet” on page 36). The 
assembler source code in Figure 26 provides working definitions. Add this source 
code to the source code for the mode table, assemble it and re-link it to 
SYS1L.VTAMLIB. 


TITLE 'SNASVCMG! | 
KAEKEKEKKEKEEKEKKEEKEEKEKKEKEKEKEKRRKRKKEKKEKEKEKERREREEKKEKEKEKKEKEKEKREKEKEKKE 
' LOGHODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING * 
* AS LU 6.2 DEVICES * 
KKEKKEKKKKEKKEEKKEKKEEEKKEKEEKEKKEKEKRKRKKKKKKRKEKEKEKEKKEKKREREKREKEEKKEKKKKKKEKEESK 
SNASVCHG MODEENT LOGMODE=SNASVCMG, FMPROF=X'13", TSPROF=X'07', 

PRIPROT=X'BO', SECPROT=X'BO',COMPROT=X'DOB1', 
RUSIZES=X '8686' ,ENCR=B'0000' , SSNDPAC=7, 
PSERVIC=X '060200000000000000000300',, 
SRCVPAC=7 , PSNDPAC=7, TYPE=0 

TITLE '#INTER! 


KEKKEKRKEKKEKEKKEKKEKKKEKEKEKKEEKKEKKEKEREKEKKEKKEKREKEEKKKEKEREKKEKKKKKKKKEKKKKKSK 


+ © + 


* * 
= LOGHODE TABLE FOR INTERACTIVE SESSIONS ON RESOURCES . 
- CAPABLE OF ACTING AS LU 6.2 DEVICES . 
* , * 


KKERKKEKKEKEKEKEKKKEKEKKEKKEKEKEKEEKKEKEKEKKEKEKEKEKREKEKEEKKKEKREKERKEKKEKEKEKEK 

#INTER MODEENT LOGMODE=#INTER, * 
ENCR=B'0000', SSNDPAC=7, * 
SRCVPAC=7 , PSNDPAC=7 


Figure 26. VIAN Mode Definitions - SNASVCMG and ?MODE? 


partner or intermediate node 

To define a link to a partner or intermediate node, create a VWTAM switched major 
node with a physical unit (PU) definition. If the partner LU 1s in the same system 
(APPC’' MVS or another CICS region, for example), skip this section and go to 
“Configure to run as a server” on page 46. | 


Note: The examples here are for APPN nodes and LEN nodes. If the partner LU 
is in another $/390 host, subarea routing must be used and VIAM on both hosts 
must have proper paths defined to allow CICS to communicate with the partner 
LU. 


Since the next node in the path to the partner LU may be just an intermediate hop, 
the term adjacent link will be used to name the link chosen to route the traffic to 
the partner LU. 


For most APPC systems communicating with CICS, the link to the host $/390 is 
activated by the remote system, not by VTAM. (CICS does not know about link 
definitions at all.) The examples shown here represent APPN nodes or LEN nodes 
that activate links to VTAM. 7 


44° Mult-platform APPC Configuration Guide 


Below 1s a sample WITAM switched major node. 


2SWNETNODE? VBUILD TYPE=SWNET ,MAXGRP=6 ,HAXNO=6 # note l 

2LINKNAME? PU ADDR=04, X # note 2 
CPNAME=? PARTNERCP?, X # note 3 
PUTYPE=2, X 
MAXDATA=2057, X 
HAXPATH=1 

?PARTNERLU? LU LOCADDR=0,ISTATUS=ACTIVE, X # note 4 
HMODETAB=2MODETABLE? , DLOGMOD=?MODE? # note 5 

Figure 27. VTAM Switched Major Node - SYSI].VTAMLST(SW NETNODE?) | 

Notes: 

1. The name of the switched node (?SWNET NODE?) is the label of the VBUILD 
statement. 


2. VITAMI thinks of PUs as links; this name is strictly internal to VTAM. 


3. The CPNAME in this definition is obtained from the partner (or defined by the 
V TAM system programmer and given to the person setting up the partner com- 
puter). It must match exactly. The network name is by default the same as 
VTAM’s (see “How to find...” on page 55). 


4. On the platforms that will use this form of VTAM definition, it is quite likely 
that PPARTNERLU? and ?PARTNERCP? are one and the same. In fact, for 
Networking Services/DOS, this 1s a requirement. 


. WTAM only requires that the mode name be in the mode table. Making it the 
default (DLOGMOD) just makes things tidier. Note that the mode name 
SNASVCMG must also be in the mode table. 


Ca 


If the partner computer has a different network name than VTAM’s, then you must 
have VTAM Version 3 Release 4 or later to use the following definition. The 
partner computer 1s said to be in a non-native network. 


?SWNETNODE? VBUILD TYPE=SWNET ,MAXGRP=6 ,MAXNO=6 

?7LINKNANE? PU ADDR=04, X 
CPNAME=? PARTNERCP?, Xx 
PUTYPE=2, X 
HAXDATA=2057, X 
MAXPATH=1, X 

XNETALS=YES, X # note 1 
NETID=? PARTNERNET? # note 2 

?PARTNERLU? LU LOCADDR=0,ISTATUS=ACTIVE, X 
HODETAB=? MODETABLE? , DLOGHOD=?MODE? 


Figure 28. VIAN Switched Major Node, Non-Native Network - 
SYSLVTAMLST@C@SWNETNODE?) 
Notes: 


1. The XNETALS = YES is needed here only if it is not coded in the VTAM start 
options. It is only valid with VTAM V3R4 or later. ~ 


2. The NETID is the partner network name from the worksheet in “CICS Config- 
uration Worksheet” on page 36. 
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Configure to run as a server 
To configure CICS as a server you must define the following: 


¢ a CONNECTION object (with the partner LU name) 

¢ a SESSIONS object (with the mode name for the session) 

¢ a TRANSACTION object (with the TP Name to be started) 
¢ a PROGRAM object (used by the TRANSACTION object) 


In CICS, objects have properties such as authorization lists (what user-ids can use 
the object), resources required (memory, buffers), etc. CICS manages all these to 
provide low response tume. 


Note: To distinguish CICS objects, such as a CONNECTION, from more generic 
usages, the CICS object names will be in upper case. For example, a PROGRAM 
refers to the CICS definition for a program object, while a program can be any exe- 
cutable file or load module. 


To create and modify definitions in CICS start the CEDA transaction. All defi- 
nitions in CICS are kept in groups. Most object identifiers must be globally unique, 
that 1s, cannot be used in any other group. SESSIONS objects are an exception to 
this rule. In the following sections all the definitions are in the same group. 


Defining a CONNECTION 


To define a connection in CICS, type the following at a clear screen: 


ceda define group(?GROUP2) connection(?CON?) 


CICS folds all characters to upper-case, so you don’t have to worry about typing 
lower-case characters. If the group does not exist, CICS will create it for you auto- 
matically. Figure 29 on page 47 shows the 3270 screen that results from this 
command. CICS fills in the group name and the CONNECTION identifier from 
the values you typed. On this screen and all other CICS screens, if a value must be 
selected from a list, then the part of the list value that 1s upper-case serves as a 
short-name. For example, the ACcessmethod parameter has options of Vtam, IRc, 
INdirect, and Xm. To select Vtam, typing “V” 1s the same as typing “VTAM.” 
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OVERTYPE TO NODIFY CICS RELEASE = 0330 
CEDA DEFine 
Connection ; 2CON? # note ] 
Group : 2GROUP? 
DEscription ==> PARTNER LU 
CONNECTION IDENTIFIERS 
tletname ==> ?PARTHERLU? # note 2 
ItHDsys ==> 
REMOTE ATTRIBUTES 
REHOTESystem ==> 
RENOTEName ==> 
CONNECTION PROPERTIES 


ACcessmethod ==> Vtam Vtam {| IRe | INdirect | Xm 

Protocol ==> Appc Appc | Lu6l # note 3 
SInglesess ==> No No | Yes # note 4 
DAtastream ==> User User | 3270 | SCs | STrfield | bLms 

RECordformat ==> U U | Vb 
OPERATIONAL PROPERTIES 

AUtoconnect ==> No No | Yes | All # note 5 
INService ==> Yes Yes | No 
SECURITY 

SEcurityname ==> 

ATtachsec ==> Loca] Local | Identify | Verify | Persistent # note 6 

| Mixidpe 
BINDPassword ==> PASSWORD NOT SPECIFIED 
BItDSecurity ==> No No | Yes 


APPLID=TOCICS3 


Figure 29. CEDA DEFINE GROUP@GROLP?) CONNECTION 


Required parameters: 


l. 
2 


Connection 1s a 1-4 character nickname for this partner LU. 


Netname is the partner LU name. The netname must match a VTAM defi- 
nition, either from a dynamically-defined cross-domain resource (CDRSC) or 
from a static definition in a WTAMLST member. (See Figure 27 on page 45.) 
CICS uses netname to refer to 7PARTNERLU? and doesn’t allow you to set 
the partner network name. Remember, the fully-qualified partner name 1s 
9NETWORK?.2PPARTNERLU? (for example, USNET].PARTNER). 


Protocol must be entered and must be APPC. 


. SInglesess must be set to NO. The example definitions in this guide all require 


parallel sessions. 


. The “+” sign indicates the bottom of the first screen displayed by CEDA. The 


function key settings are displayed at the bottom of the screen (but not shown 
here). 


. Altachsec specifies the type of security that can be used. Persistent means that 


this partner sends a user-ID and password the first time it tnes to start a trans- 
action; subsequent transactions are sent with just the user-ID and some bits that 
say “persistent verification - already signed on.” CICS V3R3 will keep a table of 
logged-on users. The partner system can still try to start a program with no 
secunty and if the transaction does not require security, it will run. However, 
transactions that require RACF user-ID authonzation would fail in such cases. 


Here the default, “Local,” means that any transaction that can be run by the 
default user-ID, CICSUSER, can be run by this partner LU. 
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Defining SESSIONS 
To define the mode name and session charactenstics for the partner LU a SES- 
SIONS definition must be created. The following command builds a 3270 screen 
that allows you to do so. 


ceda define group(?GROUP?) sessions(?SESSION?) — 


Figure 30 shows the 3270 screen that you should as a result. 


OVERTYPE TO MODIFY -CICS RELEASE = 0330 
CEDA DEFine 
Sessions : 2SESSION? # note 1 
Group : 2GROUP? 
DEscription ==> ?MODE? SESSIONS FOR PARTNER LU 
SESSION IDENTIFIERS . 
Connection ==> 2CON? # note 2 
SESSName 
NETnameq 
HOdename 
SESSION PROPER 
Protocol 
HAx imum 
RECEIVEPfx 
RECEITVECount 
SENDPf x 
SENDCount 
SENHDSize 
+ RECEIVESize 


# note 3 


Appc | Luél 
0-999 # note 4 


1-999 


1-999 
1-30720 
1-30720 


Hv Hf fH ff tf ff tH —+ tH Nh on 


APPLID=TOCICS3 


Figure 30. CEDA DEFINE GROUP?GROUP?) SESSIONS 


Required parameters: 


1. Sessions is the CICS name for this session set. The name must be unique 
within this group. 

2. Connection identifies the CICS connection in this group (in other words, the 
partner LU) associated with this mode name. 


3. Afodename specifies the mode for this group of sessions. 


4. Maximum specifies the number of sessions for this mode name. The values 
shown here match the default values for the mode names #INTER and 
+BATCH as defined in APPN end nodes and network nodes. 


Define transaction program - server 
To define a transaction program in CICS requires two things, a TRANSACTION 
anda PROGRAM. The TRANSACTION definition assigns the unique four- 
character transaction identifier for this CICS region, while the PROGRAM estab- 
lishes characteristics of the executable code. The examples here show the server side 
of APING, namely APINGD. 


To define the APINGD program, type the following command: 
ceda define group(?GROUP?) program 


You should see the screen shown in Figure 31 on page 49. 
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OVERTYPE TO MODIFY CICS RELEASE = 0330 
CEDA DEFine 
PROGram : 2SERVERPGM? # note 1 
Group : ?GROUP? 
DEscription TEST PROGRAM TO ALLOCATE AND DEALLOCATE 
Language Cc CObol | Assembler | Le370 | C | Pli # note 2 
| Rpg 
No No | Yes 
No No | Yes 
Norma | Normal | Transient 
USE] pacopy No No | Yes 
Status Enabled Enabled | Disabled 
RS} : 00 0-24 | Public 
Cedf Yes Yes | No 
DAtalocation Below Below | Any 
EXECKey > User User | Cics 
REMOTE ATTRIBUTES 
RENOTESystem ==> 
+ REHOTEName ==> 


RELoad 
RESident 
USAge 


Vv 


Vv 


==> 


Vv 


APPLID=TOCICS3 


Figure 31. CEDA DEFINE GROUP(??GROUP?) PROGRAMI 


Required parameters: 


1. Program is the name of the member of 7APINGLIB? that contains the 
APINGD executable code. (See Figure 23 on page 42 for the JCL to include 
this load library in CICS’ search list.) 


2. Language specifies the source language of the program. The APINGD sample 
program 1s wnitten in C, so the defauit, Coboi, musi be changed. There is a 
Cobol version of APINGD that will run on CICS systems that do not have 
CPI-C support (such as CICS Version 2 Release 1.2) or that do not have the C 
run-time libranes. The Cobol source code 1s available on CompuServe, the 
IBM BBS, and MKTTOOLS. 


To define the transaction, type the following command: 


ceda define group(?GROUP?) transaction 


The resulting screen should resemble that shown in Figure 32 on page SO. 
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OVERTYPE TO HODIFY CICS RELEASE = 0330 
CEDA DEFine 
TRansaction : ?SERVERTRAN? # note l 
Group >. 2GROUP? 
DEscription APING SERVER TRANSACTION . 
PROGram ?SERVERPGM? # note 2 
TWwasize 00000 0-32767 
PROFile DFHCICST 
PArtitionset 
STatus Enabled Enabled | Disabled 
PRIHedsize : 60000 0-65520 
TASKDATALoc ==> Below Below | Any 
TASKDATAKey ==> User User | Cics 
REHOTE ATTRIBUTE 


voev 


VV 


Lr a | | 
Vv 


no ft © #f NW 


Vv 


> 
s) 
> 


DYnamic No No | Yes 
REMOTESystem 
RENOTEHame 
TRProf 


+ Localg 


> 
> 
> 


> No | Yes 


APPLID=TOCICS3 


Figure 32. CEDA DEFINE GROUPQ?GROUP?) TRANSACTION 


Required parameters: 


1. Transaction is the one-to-four character transaction id. The APING client spec- 
ifies a remote TP name of APINGD (as a default). When CICS receives a 
request to start a transaction, it only looks at the first four characters of the TP 
name. Therefore APIN must be the transaction id used by this program. 


2. Program is a pointer to the PROGRAM definition. In this case the 
PROGRAM definition has the same name as the program. 


The other values shown in this example are local system defaults. 


INSTALLing the Definitions 
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Before any definitions can be used they must be added to the running CICS System 
Definition (CSD) using the INSTALL command. This 1s accomplished by typing 


CEDA INSTALL GROUP(?GROUP?) 
This command will install all the objects in the group - CONNECTIONs, SES- 


SIONS, PROGRAMs, etc. Some objects can be installed individually, too. Here is 
an example of installing a change to the program APING: 


CEDA INSTALL GROUP(?GROUP?) PROGRAM (APING) 


If a resource is in use, or /n Service in CICS terms, the installation will fail. If you 
get the INSTALLATION FAILED message, you can display the messages by 
pressing the PF9 key. This shouldn’t happen the first tume, though. 


If you need to take a CONNECTION out of service, or disable a TRANSACTION 
or PROGRAM, use the CEMT transaction (see “Working with CICS and VTAM” 
on page 39). 
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Configure to run as a client 
Only the client has to deal with CPI-C side information and CICS provides a 
default entry that allows programs to use CPI-C with no predefined side informa- 
tion. APING will accept a fully-qualified partner LL name 
(NETWORK?.2PARTNERLU?) as the partner LU parameter. Therefore, the fol- 
lowing two definitions are not necessary if the connection and sessions definitions 
follow the guidelines stated above. 


The PARTNER definition contains most of the details, but the default profile uses 
a blank mode name. The PROFILE definition uses the INTER mode name. 


Define CPI-C Side Information (OPTIONAL) 
To define CPI-C side information in CICS you must create a PARTNER definition 
and a PROFILE definition. Both are optional. You can invoke APING with 
either the CICS netname (7PARTNERLU?) or a fully-qualified partner LU name 
ONETWORK?.2PARTNERLU?) and APING will work properly. 


To create a PARTNER definition, type the following command in CICS: 
ceda define group(?GROUP?) partner 


The 3270 screen shown in Figure 33 should appear. Type in the values for Partner, 
Netname, Network, and TP name from the worksheet in “CICS Configuration 
Worksheet” on page 36. 


> 


OVERTYPE TO HODIFY CICS RELEASE = 0330 

CFDA DrFine . 

PARTHer : ?SYMDEST? . # note l 
Group : ?GROUP? 

Description “==> CPi=C S106 INFO 
REMOTE LU NAHE 

HETHlame ==> ?PARTNERLU? # note 2 
HETHork ==> ?PARTNERNET? # note 2 
SESSION PROPERTIES 

Profile ==> DFHCICSA # note 3 
REHOTE TP NANE 

Tpname ==> 2?TPNAHE? # note 4 

=<> 
Xtpname ==> 


> 


APPLID=TOCICS3 


Figure 33. CEDA DEFINE GROUP@GROUP?) PARTNER. The CPI-C side informa- 
uion. 
Required parameters: 
1. Partner is the name for this resource in CICS. 
2. Netname is the partner’s LU name. Network 1s the partner’s network name. 


3. Profile is the set of characteristics this partner has. The most important of these 
is the modename. The default profile, DFHCICA, works if the program sets 
the mode name explicitly. APING does set the mode name to SINTER as the 
default. 


4. Tpname is the initial setting for the remote TP name. This can be overridden in 
the program using Set_TP_ Name (CMSTPN). The TP name must match a 
corresponding TP definition at the remote system. 
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To define a PROFILE to explicitly set the mode name for the CPI-C side informa- 
tion, type the following command: 


ceda define group(?GROUP?) profile 


The screen shown in Figure 34 should appear. Type in the values for 7?PROFILE? 
and ?\{ODE? from the worksheet in “CICS Configuration Worksheet” on page 36. 


OVERTYPE TO MODIFY CICS RELEASE = 0330 
CEDA DEFine | 
PROFile : 2PROFILE? # note 1 
Group : 2GROUP? 
DEscription CPI-C PROFILE TO CHANGE MODE NAHE 
Scrnsize Default Default | Alternate 
Uctran No No | Yes 
NOdename ?HODE? . # note 2 
PRIntercomp No. Yes 
JOURHALLING 
Journa] Ho 1-99 
HSGJrn] No INPut | Output {| INOut 
PROTECTION 
HSGinteg 
Onewte 
PROtect 
Chaincontrol] 
PROTOCOLS 
+ DVsuprt All | Nonvtam | Vtam 


Vv 


Vv 


oon wm om oft 
oon Hf mH on 
Vv 


Vv 


No Yes 
Yes 
No Yes 
Yes 


APPLID=TOCICS3 


Figure 34. CEDA DEFINE GROUP?GROUP?) PROFILE 


Required parameters: 


1. Profile is the name for this resource. This name must match the Profile param- 
eter in the PARTNER definition. 


2. \/ode name identifies the mode for this side info entry. There must be a SES- 
SIONS definition with the same modename. (Remember, this profile entry is 
optonal if the application uses a default mode name, as APING does.) We 
recommend that ?4MODE? be 4INTER or one of the other mode names that 
ship with APPN products - #BATCH, #INTERSC, or #BATCHSC. 


Define transaction program - client 
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efining the chent TRANSACTION and PROGRAM 1s just like defining the 
server as descnbed in “Define transaction program - server’ on page 48. To define 
the PROGRAM, type the following in CICS: 


ceda define group(?GROUP?) program 


You should get the screen shown in Figure 35 on page 53. 
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OVERTYPE TO NODIFY CICS RELEASE = 0330 
CEDA DEFine 


PROGram : 2CLIENTPGH? # note 1 

Group : 2GROUP? 

DEscription ==> APING CLIENT PROGRAM 

Language ==> C CObol | Assembler | Le370 | C | Pli # note 2 
| Rpg 

RELoad ==> No No | Yes 

RESident ==> No No | Yes 

USAge ==> Hormal Normal | Transient 

USElpacopy ==> No No | Yes 

Status ==> Enabled Enabled | Disabled 

RS] : 00 0-24 | Public 

Cedf ==> Yes Yes | No 

DAtalocation ==> Below Below | Any 

EXECKey ==> User User | Cics 


REMOTE ATTRIBUTES 
REMOTESystem ==> 
REMOTEName ==> 
Transid ==> 
EXECUtionset ==> Fullapi Fullapi | Dplsubset 


APPLID=TOCICS3 


Figure 35. CEDA DEFINE GROUP?GROUP?) PROGRAM. Here you tell CICS about 
the executable program. 


Required parameters: 


1. Program is a member of the MVS load library 7APINGLIB? included in the 
DFHRPL DD concatenation lst in the CICS start-up procedure. (See 
Figure 23 on page 42.) 


2. Language must be set to C. 
To define the TRANSACTION, type the following in CICS: 


ceda define group(?GROUP?) transaction . 


You should get the screen shown in Figure 36. Modify the Transaction and 
Program fields as descnbed in the notes. 


OVERTYPE TO MODIFY CICS RELEASE = 0330 

CEDA DEFine 
TRansaction : 2CLIENTTRAN? # note l 
Group : 2GROUP? 
DEscription APING CLIENT TRANSACTION 
PROGram 2CLIENTPROG? # note 2 
TWasize 00000 0-32767 
PROFile DFHCICST 
PArtitionset 
STatus Enabled Enabled | Disabled 
PRINedsize : 00000 0-65520 


viv 


Vv 


ft uo of a ft 
" “oo " “uo 


TASKDATALoc ==> Below Below | Any 


TASKDATAKey > User User | Cics 
REMOTE ATTRIBUTES 

DYnamic ==> No No | Yes 
REHOTESystem 
REMOTEName 
TRProf 


+ Localg 


en ee 
"ow ott 
vVvyv 


a 
Vv 


No | Yes 


APPLID=TOCICS3 


Figure 36. CEDA DEFINE GROUP(??]GROUP?) TRANSACTION 
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Required parameters: 


1. Transaction is the four-character transaction id. This must be unique in this 
CICS region. As this transaction is started by a local terminal user, it does not 
need to match anything specified at the remote system. 


2. Programs a pointer to the PROGRAM object defined in Figure 35 


Remember to CEDA INSTALL your new definitions! (See “INSTALLing the 
Definitions” on page 50.) 


Running APING 


To run APING, type any of the following commands at a clear CICS screen (don’t 
forget the period if you use the first format): 


27CLIENTTRAN? -n ?PARTNERNET?.?PARTNERLU? 
2CLIENTTRAN? -n 2?PARTNERLU? 
27CLIENTTRAN? -n ?SYMDEST? 


You should see the APING logo and output. The “-n” switch tnes to start the 
APINGD transaction on the remote computer without any secunty information 
(user-ID and password). 


Note: If you are running with RACF, your transaction must be authorized and 
your user-ID must be authonzed to use it. If you get an error message like 
*DFHAC2033 ... Your are not authorized to use transaction XXXX.” you will need 
to contact your RACF administrator. 


You may need to manually start a session between CICS and the partner LU, since 
CICS does not do this automatically. To start a session with the partner session, at 
a CICS screen type this command: 


cemt ing con(?CON?) 


You wil get the screen shown in Figure 37. By the connection and netname for 
the partner LU you should see “Ins Acq.” This is CICS short-hand for “In-| 
service, acquired.” If the status 1s “Ins Rel,” overtype the “Rel” with “Acq” and 
press the enter key. The resulting screen should now have “Ins Acq” as the status. 
If not, contact your VTAM systems programmer and make sure that the partner 
LU is active. You can also use the commands described in “Other commands” on 
page 40 to display or activate the partner LU or switched major node. 


INQ CON(?CON?) 


STATUS: RESULTS - OVERTYPE TO HODIFY 
Con(?CON?) Net (PARTHERLU?) Ins Rel NORMAL 


Figure 37. CICS Status for Connection ?CON? 
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How to find... 


HOSTSA=1, 
SSCPID=01, 
SSCPHAME=?2CPNANE? , 
DYNASSCP=NO, 
Ne TID=?NETWORK?, 
MAXSUBA=63, 
CONF IG=00, 
NOPROHPT , 

ec: 


LU Name 


If you can logon to the CICS region to begin defining partners. the CICS LU 
name appears on the bottom nght of the screen as APPLID = 7LUNAME?. 
Here that’s TOCICS3. 


Control Point (CP) Name 


In MVS systems, the CP name is equivalent to the name of the VITAM System 
Services Control Point (SSCP). It takes its value from the SSCPNAME param- 
eter in ATCSTRxx (see Figure 38). 


Network Name 


The network name can be found in the VIAM start list member of 
SYSLWTAMLST. Look for a member named ATCSTRxx, where xx 1s 00 or 
TS or something. It should look lke this: 


>< > OK OK OOK OOK KOK 


igure 38. The ViANi Start Parameier List - SYSILWTAMILST(ATCST ROO) 


* 


LAN Address 


The LAN address for a CICS host connected to a token nng through a 3745, 
3720, or 3725 1s in the NCP gen in SYS1].VITAMLST. Look for a GROUP 
macro statement with ECLTYPE= PHYSICAL and immediately after that 
should be a LINE macro with a LOCADD parameter. That is the LAN 
address. Here is an example: 


BUILDING RING DEFINITIONS (PHYSICAL) 


TO30T2PG GROUP ECLTYPE=(PHYSICAL,ANY), * 
TYPE=NCP, * 
etc. 

TO30T2PL LINE ADDRESS=(1089, FULL) ,LOCADD=? LANADDRESS? , PORTADD=2, = 
RCVBUFC=4095, MAXTSL=692, ADAPTER=T1C2, TRSPEED=4, * 


UACB=(XSP2AX, XSPZAR) 


Figure 39. Portion of NCP Gen with LAN Address 


CICS Configuration 55 


56 = Multi-platform APPC Configuration Guide 


Networking Services/DOS Configuration 


Prerequisites 


Terminology 


Networking Services/DOS is a software product that supports APPC in the DOS 
and Microsoft Windowss 3.0 and 3.1 environments. Networking Services: DOS 
allows a DOS machine to participate as a low entry networking node (see “What Is 
APPN?” on page 6 for a discussion of node types). This chapter descnbes how to 
configure Networking Services/DOS running on DOS 3.3 or later on a workstation 
with a token-nng adapter connecting it to a token ring local area network. 


e¢ Networking Services;DOS, Version 1.0, Part number 20G0437 
¢ DOS, Version 3.3 or greater 


¢ Local Area Network Support Program, Version 1.3 (Supplhed with Networking 
Services (DOS) 


¢ Token nng adapter 


For additional configuration information, refer to the Networking Services; DOS 
User's Guide and Reference, S20G-0438-00 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by Networking Services/DOS. 


Local LAN Address adapter address 


Adjacent LAN Address remote computer LAN address 


Networking Services/DOS Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table 1s split into two parts: values determined by referring to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (?), the middle column describes 
what the vanable is used for and how to determine the value, and the nght-most 
column 1s for you to fill in with a value. Whenever there is a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
neht column. 
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For example, if you are following the recommendations in the Worksheet, you will 
write #/\7ER in the nght column on the 7MODE? line. Then in Figure 42 on 
page 62 you will type #INTER on the line to replace “7? MODE” Lke this: 


2?SYMDEST? ?PARTNERNET?.2PARTNERLU? #INTER 2? TPNAME? 


Likewise, the other symbols on the line above will be replaced with the appropriate 
values from the nght column of the Configuration Worksheet. 


Symbol How to determine the value for this symbol Fill in value 
| here 


Values that must match with other places 


2?LUNAME? 


This is the LU name of the machine you are defining to the 
network. Refer to “How do I Configure a Network?” on page 7 
for information on how to define this value. 


?NETWORK? This is the network name of the machine you are defining to the 
network. Refer to “How do I Configure a Network?” on page 7 


for information on how to define this value. 


?PARTNERLU? This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 


value. 


TPARTNERNET? | This is the network name of the partner computer. Use the 
network name from the partner computer’s “How to find...” — 
section. 


7LANADDRESS? | This is the LAN Address of the partner computer. (Or the LAN 
Address of a network node, if the link 1s being made to a 
network node.) Refer to the “How to find...” section of the 


partner computer's configuration chapter for this value. 


?TPNAME? This is the name of the transaction program at the partner com- 
puter. It is a name that is sent across the network to the server 
machine. The server machine then maps this TP Name to an 
executable program. The TP Name is usually specified in a 
client server product’s documentation. For APING, the TP 
Name on the server is APINGD. 


2MODE? See “What Is a Mode?” on page 5 for a discussion of modes. 
Often, a chent’server product’s documentation specifies what 
mode must be used by that product. APING can use any mode 
(this can be specified on the APING command line), but the 
default is #INTER. It 1s recommended that you use one of the 
architected modes discussed in the “What Is a Mode?” section. 


Local values 


?LINKNAME? 


1 to & letters or numbers which will be used as a local name on 
the Networking Services/DOS machine to refer to the link to a 
partner computer. Suggestion: LINKO001 
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Symbol How to determine the value for this symbol 


?9SYMDEST? This 1s the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. It will be used locally 
on the Networking Services/’DOS machine to refer to a CPI-C 
side information entry. Suggestion: use the same value as 
ILUNAME?. 


Fill in value 
here 


7TPPATH? This is the fully-specified path and filename of the executable 
code for a server transaction program located on your machine. 
For example, if Networking Services’ DOS is installed on the C:\ 
dnve, this value could be: 


C:\NSD\SAMPLES\APING\APINGD. EXE 


Working with Networking Services/DOS 


Starting/stopping APPC 
Once your Networking Services, DOS configuration files are set up, you Start Net- 
working Services/DOS by issuing this command: 


NSD START CONFIG.NSD 


You can stop Networking Services/DOS and unload it from memory by issuing the 
command 


NSD STOP /U 


Other commands 
You can display active APPC sessions by issuing the command: 


NSD LIST /SESSION 


This command may be useful in determining where an error may be occurnng if 
APING does not run successfully. 


Configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
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4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


Working with APPC configuration 
Networking Services/DOS configuration is done through configuration files that are 
loaded and interpreted when an NSD START command is issued. These files are: 


¢ CONFIG.NSD 

¢ SIDEINFO.NSD 
¢ DEFINETP.NSD 
¢ MODE.NSD 


All these files need to be in the same directory. When Networking Services/DOS 1s 
started, it searches for these files in the current directory. To get Networking 
Services, DOS up and running from the .NSD files supplied with NS/DOS (in the 
\NSD EXAMPLES subdirectory), you only need to alter the CONFIG.NSD and 
DEFINETP.NSD files. 


Define yourself to the network 
Before an Networking Services/DOS machine can communicate on a network, it 
must define itself to the network. This is done with an NSDN statement in the 
Networking Services; DOS’s CONFIG.NSD file. The NSDN statement specifies the 
fully-qualified LU name of the DOS machine. 


Networking Services/DOS provides many sample configuration files in the 
\NSD.EXAMPLES directory. To use the token-nng example as your base config- 
uration file, copy TKRING.NSD from the \NSD:.EXAMPLES directory to 

\NSD .CONFIG.NSD. Then, throughout this chapter, make changes to this 
CONFIG.NSD as indicated in the examples. 


NSON 2NETWORK?. ?LUNAME? 
Figure 40. Define yourself to the network - (in CONFIG.NSD) 


Additional common configuration 
There are several more statements that can be added to your CONFIG.NSD to 
improve performance or to specify more detailed information about how Net- 
working Services/DOS runs in your machine. See the Networking Services/DOS 
U’ser’s Guide and Reference to learn more about them. Here we will discuss just 
two of these statements that you may have to configure to get Networking 
Services‘DOS to run. These statements control access to resources within your 
machine that may already be used by something else. 


The NSDI statement controls which DOS interrupt Networking Services/DOS will 
claim. You only need to use this statement if there are problems running the NSD 
START command. The default interrupt 1s 0x68. If you receive an error message 
when running the NSD START command that indicates that an interrupt is already 
in use, change (or add) the following line in your CONFIG.NSD, specifying a dif- 
ferent interrupt number: 


NSDI 68 /* valid values are 60 through 68 */ 
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Another problem you may encounter, due to possible conflicts with other software 
running on your machine, 1s a conflict in which SAP (service access point) Net- 
working Services; DOS uses when it opens the LAN adapter. The default value 1s 
04. If you receive an error message when running the NSD START command that 
indicates there 1s a SAP conflict, add the following line to your CONFIG.NSD, 
specifying a different SAP: 


TRSS 04 /* valid values are X'Q4' through X'FC' and must be */ 
/* divisible by 4. X'08' is recommended as a i 
/* second choice. Then try 'OC', '10', '14', '18'...*/ 


Note: The SAP you use must also be within the partner computer’s valid range, so 
try to use as small a value as possible, such as 08 or OC. 


Define a link to a partner or network node 
In order to start a conversation with another node, you must define a link to that 
node, or a link to a network node. 


If you choose to define multiple links, you may also need to execute a command 
that tells Networking Services,DOS which link to use to find a particular partner 
LU. 


Defining a link 
A link 1s defined with the TRLD statement: 


TRLD ?LINKNAME?, ?LANADDRESS? 


Figure 41. Detine a link - Gn CONFIG.NSD). 


Other link configuration 
You can define more than one link by including more than one TRLD statement in 
your CONFIG.NSD file. When an APPC program attempts to establish a conver- 
sation with another node, Networking Services; DOS has to determine which link to 
route APPC traffic on. Networking Services‘DOS will first search to see if a link 
has been assigned to the partner LU by a previous session activation. If so, that 
link is used; if not, Networking Services, DOS will send the request to find the 
partner LU to the first link specified in vour CONFIG.NSD. If the partner LU 1s 
to be located through a different link, vou must, in addition to defining the link with 
a TRLD statement, specify which link the LU should be found through. To do 
this, you must run the NSD ACTIVATE command after starting Networking 
Services’ DOS with NSD START. The NSD ACTIVATE command looks like 
this: | 


NSD ACTIVATE LU=?PARTNERNET?.?PARTNERLU? LINK=?LINKNAME? 


Configure to run as a client 


Define CPI-C side information 
Some applications, like APING, do not require CPI-C side information to run. 
These applications use programming calls available on a particular platform to 
dynamically create side information when running. Networking Services’DOS pro- 
vides the programming calls that allow APING (and other apphcations) to do this, 
so for APING, you do not need to create this Side Information profile. For those 
applications that require CPI-C Side Information, this is how to create a profile: 
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CPI-C side information is defined in the SIDEINFO.NSD file. To add a CPI-C 
side information entry, edit this file and add a line specifying the Symbolic Destina- 
tion Name, Partner LU Name, Mode Name, and Transaction Program Name as 
follows: | 


2SYMDEST? ?PARTNERNET?.2PARTNERLU? ?HODE? ?TPNAHE? 
Figure 42. Define CPI-C side information - (in SIDEINFO.NSD) 


Configuring to run as a server 


Define transaction programs 
To run Networking Services/DOS as a server, you must, in addition to the common 
configuration steps above, define a transaction program (TP) on your machine that 
will be started when the client establishes the conversation. The TP is defined in 
the DEFINETP.NSD configuration file. Here is the syntax of this statement in 
DEFINETP.NSD: 


?TPNAME? ?TPPATH? * * OPERATOR STARTED 


Figure 43. Define a transaction program - (in DEFINETP.NSD). The asterisks indicate 
that you want to accept the default timeout values when starting the transaction 
program. 


The last value on the line specifies the “IP program operation”. This parameter 
indicates how the TP 1s started. It can be one of the following: 


ANE STARTED 
the Program Launcher starts the program. The Program Launcher 
operates only in the Microsoft(T1) Windows environment. 


OPERATOR_STARTED 
the Networking Services/DOS user starts the program. If you are not 
running in the Microsoft Windows environment, this 1s your only 
option. (Actually, if you’re not running in the Microsoft Windows envi- 
ronment, the TP program operation parameter is ignored because 
OPERATOR_STARTED 1s the only valid operation). 


Running APINGD 
After running NSD START with the updated information in DEFINETP.NSD, 
you should be able to APING the Networking Services;DOS machine from another 
machine. If you are using the Program Launcher in the Microsoft Windows 
einvironment, you must start the Program Launcher before starting APING on the 
partner machine. To start the Program Launcher, double-click an icon created from 
the \NSD NSDPLW.EXE file, or place this icon in the startup folder to have the 
program launcher started whenever Windows 1s started. 


If you are not using the Program Launcher, you wil have to manually start 


APINGD.EXE on the Networking Services; DOS machine. This can be done before 
or after you start APING on the partner machine. 
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Running APING 


How to find... 


You should now be able to APING any of the computers you configured to using 
the steps above. 


To run APING, issue this command: 


APING -n 2SYMDEST? 


or you can specify the fully-qualified LU name of your partner: 
APING -n 2?PARTNERNET?. ?PARTNERLU? 


If Networking Services; DOS should try to locate the partner machine on a link 
other than the first one specified in your CONFIG.NSD, you need to run the “NSD 
ACTIVATE” command after starting Networking Services; DOS, and before 
APINGing that partner machine. For example: 


NSD ACTIVATE LU=?PARTNERLU?.?PARTNERNET? LINK=?LINKNAME? 


¢« IU name 


The LU name 3s specified in the CONFIG.NSD file on the NSDN line. The 
LU name consists of the entire string folowing the penod. 


« Network Name 


Ihe network name is specified in CONFIG.NSD on the NSDN line. The 
network name is the 1-8 characters preceding the penod. See “Define yourself 
to the network” on puge 60 for detaus on the syntax of the NSDN statement. 


¢ Control Point (CP) name 
The CP name 1s the same as the LU name. 
« LAN address 


The LAN address 1s a 12-digit hexadecimal value that identifies your token-nng 
adapter to the network. There is a LAN address hard-coded on the Token- 
Ring adapter in the Networking Services‘DOS machine. This hard-coded value 
is sometimes be over-ndden with something called a “locally administered 
address.” You can find the LAN address on your Token-Ring card by running 
the program LANADDR, which is supplied with Networking Services, DOS. 
When you run LANADDR, the LAN address of your machine will be dis- 
played as the “Adapter 0 in-use address”. Use the 12 hexadecimal digits dis- 
plaved. (If you have a secondary adapter installed and are accessing it with the 
Networking Services. DOS optional keyword TRAN, you would use the 
“Adapter | in-use address”.) The “in-use address” displays the “locally adminis- 
tered address” if there is one being used. 
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APPC/MVS Configuration 


Prerequisites 


Terminology 


This chapter describes how to configure APPC/MVS. The configuration is spread 
among the APPC;MVS subsystem, VTAM, and NCP. Examples of configuration 
of each are shown. 


Software and hardware prerequisites for APPC/MVS include: 
¢ MVS/ESA V4.2 or later 
© VIAM V3.3 or later 
¢ NCP V5.2 or later 
¢ 3745 with Token-nng attachment 
¢ Using the transaction program(TP) APING as a sample TP 
: Single SNA domain. 
While the 3745 is not a strict prerequisite (a 3172, for example, can be used instead) 
this document only descnbes configuration with a 3745 as gateway. 
For more detailed information on APPC/MVYS configuration and operation refer to: 
¢ MVWS/ESA Planning: APPC Management, GC28-1110 
¢ VTAN Resource Definition Reference, SC31-6438 
¢ NCP Resource Definition Reference, SC30-3448 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by APPC MVS. 


APPC/[MVS Term 
NETID | | 


LU Name name supplied for APPL definition in 
APPL major node 


Partner LL Name name supplied for LU definition in 
| major nodes other than APPL 


Local LAN Address LOCADD (in NCP gen) 


Adjacent LAN Address DIALNO (on PATH definition in 
| switched major node) 
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APPC/MVS Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by referring to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (?), the middle column describes 
what the variable is used for and how to determine the value, and the nght-most 
column 1s for you to fill in with a value. Whenever there 1s a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
nght column. 


Symbol How to determine this value | Fill in value 
here | 


V | Values that much math with other places that much match with other | Values that much math with other places 


?LUNAME? This is the symbol that refers to the LU name of the machine 
you are defining to the network. 1 to 8 character field con- 
sisting of alphanumenic characters which is the LU name of the 
node. Choose a name that is unique within the same network 
name. Refer to “How do I Configure a Network?” on page 7 


for more information about LU names. 


The value specified for the ACBNAME on the LUADD state- 
ment in the PARMLIB member APPCPMxx defines an 
APPC/MVS LU. Look in this PARMLIB member to see if 
one has already been created. 


°CPNAME? This is the symbol that refers to the Control Point name of © 
your machine. Refer to “What Is APPN?” on page 6 for 


more information about control points. 


VTAM, being a LEN node, does not have a CP (Control 
Point) name for APPN use. It does, however, have an 
SSCPNAME (System Services Control Point Name). Use the 
SSCPNAME in leu of a CP name. It 1s the value specified for 
SSCPNAME in the VTAM start options (ATCSTRxx ts the 
start options member of the VT AMLST dataset). 


| INETWORK? This 1s the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting of alphanumeric characters. There 1s a structured 
format for the network name which includes the country code, 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch 
office for the format information and to register your network 
name. Refer to “How do I Configure a Network?” on page 7 


for more information about network names. 


For systems with VTAM already configured, this value 1s 
found in the VTAMLST start options (ATCSTRxx) member. 
The option name 1s NETID. 


This is the partner’s LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 


7PARTNERLU? 
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Symbol | How to determine this value Fill in value 
here 


°LANADDRESS? This is the LAN Address of the partner computer. (Or the _ 


LAN Address of a network node, if the link 1s being made to a 
network node.) Refer to the “How to find...” section of the 
partner computer’s configuration chapter for this value. Refer 
to “How do I Configure a Network?” on page 7 for more 
information about the partner network name. 


TPPNAME? 


This is the symbol for the Transaction Program name. This is 
the name of the transaction program at the partner computer. 
For APING, the TP Name on the server is APINGD. 


This is the symbol for the mode name. See “What Is a 
Mode?” on page 5 for a discussion of modes. Often, a 
client ‘server product’s documentation specifies what mode 
must be used by that product. APING can use any mode (this 
can be specified on the APING command hne), but the default 
is #HINTER. It is recommended that you use one of the archi- 
tected modes discussed in the “What Is a Mode?” section. 


2MODE? 


Local values 


9NCPLANADDR? This 1s the local LAN address coded in NCP on a LINE 
macro using the LOCADD parameter. 


2MODETAB? Name of a logon mode table in VT AM. It 1s assembled and 
link-edited into a WITAM LOADLIB dataset. The systems pro- 
grammer should know the names of the logon mode tables 
detined on the system. This should be the name of the table 


where the APPC modes are included. 


This is the CPI-C side information symbolic destination name. 
It is any 1-8 character name vou choose. It 1s included when 
creating a side information entry. Its value matches that pro- 
vided on the DESTNAME parameter of the side information 
entry. parameter. 


"SYMDEST” 


This is the name of a volume on which VSAM datasets for 
APPC MVS will be created. It is a maximum of six characters. 


The actual JES subsystem type (JES2 or JES3) should be sub- 
stituted for this. 


The CLIST dataset in which vou put the APINGD CLIST. 


The load library dataset in which you put the APING 
program. 


°CLIST.DATASET? 


27APPC.LOADLIB? 


Working with APPC/MVS 
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Starting/stopping 


Other commands 


APPC 
The commands to start APPC;MVS are: 


START APPC ,SUB=MSTR,APPC=xx 
START ASCH, SUB=MSTR,ASCH=xx 


The xx is the identifier of the parmlib member. The default 1s 00. 


APPC/MVS is ended by issuing: 


C APPC 
C ASCH 


Once APPC/MYVS 1s activated, there are several commands that can be used to 
monitor APPC/MVS operation. A subset of these commands is shown below: 


DISPLAY APPC,TP,ALL 
DISPLAY APPC,LU,ALL 
DISPLAY ASCH,ALL 


These commands provide information on APPC/MVS TPs, LUs, and scheduler 
Operations, respectively. 
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Configuration 
Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


For APPC/MYVS, configuration 1s done in the following places: 


¢ SYS1.PARMLIB - Two parmlib members are added with parameters for the 
APPC and ASCH subsystems, respectively. 


¢ VSAM - Datasets are needed for TP definitions and CPI-C side information. 


¢ WTAM - Definitions are required in an application major node for the 
APPC: MVS LU or LUs, as well as partner definitions in a switched major node 
for LAN attached nodes, such as workstations. Additions are also need 1n logon 
mode tables for APPC modes. 


¢ NCP - The token-nng adapter must be configured, and a parameter added to 
the NCP definition to support reserve storage for APPC LUs. 


Define yourself to the network 
1. Create Parmlib members 


Place two members (ASCHPM00 and APPCPM00) in SYS1.PARMLIB. 
These two members have startup parameters for the two applications that make 
up APPC/MVS; APPC, the base APPC support, and ASCH, the job scheduler 
that handles starting applications when incoming requests are received. 
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CLASSADD CLASSNAME(FAST)  /* Specify the name of the class to be */ 


/* added */ 

MAX (10) /* Specify that the maximum number tf 

/* of transaction initiators allowed */ 

/* for this class is 10 ay 

MIN(2) /* Specify that the minimum number a 

: /* of transaction initiators to be af 

/* brought up for this class is 2 7, 

RESPGOAL(.02) /* Specify that the response time sf 

/* goal for transaction programs ut 

/* executing within this class is 0.02 */ 

/* seconds ae 

MSGLIMIT (500) /* Specify that the maximum size of */ 

/* the job logs for TPs is 500 af 

/* messages | *] 

OPTIONS DEFAULT (FAST) /* Specify the default class a A 
SUBSYS (2JES?) /* Specify the name of a subsystem lf 
TPDEFAULT REGION (4M) /* Change the region size to 4M 7, 
OUTCLASS (A) /* Change the output class to A ee 


Figure 44. SYS}.PARMLIB(ASCHPN100) - ASCFIPM00.LIB 


/* APPCPHOO wd 
LUADD ACBNAME (2?LUNAME? ) /* Add LU MVSLUO1 to the “yf 
/* APPC/MVS configuration i 

SCHED (ASCH) /* Specify that the APPC/MVS */ 

/* transaction scheduler is associated */ 

/* with this LU name a 4 

BASE /* Designate this LU as the base LU ae 
TPDATA(SYS1.APPCTP) /* Specify that VSAM data set oy 

/* SYS1.APPCTP is the permanent a 

/* repository for the TP profiles yf 

/* for this LU +7 

TPLEVEL (USER) /* Specify the search order for TP ad 

/* profiles as : ay 

/* 1. TP profiles associated with a 

- a specific user ws 

/* 2. TP profiles associated with ae & 

| i a group of users sh 

/* 3. TP profiles associated with sf 

f* all users of the LU name a 

SIDEINFO DATASET(SYS1.APPCSI) /* Specify that VSAM data set ay 4 
/* SYS1.APPCSI is the permanent */ 

/* repository for the side a 

/* information tf 


Figure 45. SYS].PARMLIB(APPCPM00) - APPCPMO00.LIB 


2. Create VTAM Application Major Node 
Place the following in a VTAMLST library (usually SYS]. VWTAMULST): 
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APPCAPP VBUILD TYPE=APPL 

27LUNAME? APPL ACBNAME=?LUNAME? , APPC=YES ,AUTOSES=1,DDRAINL=NALLOW, ss 
DM INWNL=1, DMINWNR=1,ORESPL=NALLOW,DSESLIM=2,EAS=509, 
MODETAB=?MODETAB? , SECACPT=CONV, VPACING=0,VERIFY=NONE, ’ 
SRBEX] T=YES, DLOGMOD=? MODE? 


Figure 46. VITAM definition of APPC LU - APPLMVS.VIM 


3. Add APPC Modes to the Logmode Table 


APPC modes are shown in Figure 47 on page 72. Add them to your logmode 
table, compile, and then link-edit the member into a VTAM library. Also 
include them in the default logmode table (ISTINCLM) so that dynamically 
created LUs can use them. 
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RAKKKKEKKKEKEREAERAKKRAEKKIEKRAKEKKKKAEKKREKKEEKRRERRRAKERRKKREEREKERKKKKKKKKKK 


, LOGMODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING , 
‘ AS LU 6.2 DEVICES , 
REKKKRRRREKEKREEAEKEKKEEKKEKKKEKEKKKEKEEERREREKKREREEEEREKERERKEKREKERKAERKKEH 
SNASVCHG MODEENT LOGHODE=SNASVCHG, FMPROF=X'13", TSPROF=X'07", 
PRIPROT=X'BO', SECPROT=X'BO' , COMPROT=X'DOB1', 
RUSIZES=X'8686', ENCR=B' 0000", SSNDPAC=7, 
PSERVIC=X'060200000000000000000300' , 
SRCVPAC=7, PSHDPAC=7, TYPE=0 
TITLE '#BATCH' 


RAEAKKEKKKKEKEKEKEKKEKKKEREERRKRRAKEKRKRKEEERRKEKKEERRRRKKREKKEKEREKRERAEKRKKAEKEKEK 


+ + + 


* * 
LOGHODE TABLE FOR BATCH SESSIONS ON RESOURCES CAPABLE * 
* OF ACTING AS LU 6.2 DEVICES * 
rd * 


RAERKKEKKKKEKKEKKEKKKEKKKKKEKKKEKKKKKREKRKKKKKKEREKREREKKEREKKRERERRKEREKREREEKKEK 


#BATCH MODEENT LOGHODE=#BATCH, * 
ENCR=B'0000', SSNDPAC=3, be 
SRCVPAC=3, PSHDPAC=3,RUSIZES=X'F7F?' 
TITLE ‘#INTER' 


RRAEERKKKREKRKREKKKKKKRAKKKEKKKEKKEKREKKKRAEKKKKKERRERRKEKKEKKKAKKEKARKEKKEEEKREKE 


x x 
* LOGHODE TABLE FOR INTERACTIVE SESSTONS ON RESOURCES " 
m CAPABLE OF ACTING AS LU.6.2 DEVICES - 
x *« 


RAKRRKKKKRRKKKEKKKKREKKKKKKKKKKEKKKKKREKRKKRRKAKRERRKEKKKREKKERRKRERKKKKERERAAKAREKE 


#INTER MODEENT LOGNODE=#INTER, ° 
ENCR=B'0000', SSNDPAC=7, = 
SRCVPAC=7, PSHDPAC=7, RUST ZES=X'F7F7° 
TITLE '#BATCHSC' 


KRAAKKKKEKEKRKAKKKEKKKRKREKKKKKEKEKKKEKAKKKKEKKKKRRERRERRREERRKRKKKKRKKEREKKKEKKEKKEKEK 


LOGHODE TABLE FOR BATCH SESSIONS REQUIRING SECURE 
TRANSPORT ON RESOURCES CAPABLE OF ACTING AS LU 6.2 
DEVICES 


+ + + + 
+ + + & © 


RAKKKKKKKKAKKKRRKAKKKRKKKKRKKAKAKKKKKEKAKAKEKREKKEKRKKKKARRKEKKKAKKKKAKKKAKKKKKKK 


FBATCHSC HODEENT LOGHODE=*BATCHSC, = 
ENCR=B'0000', SSHDPAC=3, " 
SRCVPAC=3, PSNDPAC=3,RUSIZES=X‘F7F7' 
TITLE ‘#INTERSC' 


RAKKKKKKKARKAKKRERKEKAKAKKEKKKEKKAKRKKKKKEARAEKEKKEREKKEARREKKEERREKREKKKEREAERK 


LOGHODE TABLE FOR INTERACTIVE SESSIONS REQUIRING 
SECURE TRANSPORT OW RESOURCES CAPABLE OF ACTING AS 
LU 6.2 DEVICES 


+ + + » © 
+> + + + 


RAKKAKAKOKKEKREKARRRKEKRAKRKR KEKE AKKKEKAKAKAAKRRAAKKKRAKRKEKRKKERKKKKEAKKKKK 


#INTERSC NUDEENT LOGHODE=#INTERSC, - 
ENCR=EB'0000',SSNDPAC=7, ss 
SRCVPAC=7, PSHDPAC=7,RUSIZES=X'F7F7' 
TITLE 'CPSVCHG' 


KRAEKKERKAKEKKEEKARKKEKRKKKKKKKEEAKKAKKKKEKKEKAKEKEREKKKKKKKEAKKEKERKEKKKKKKEKERKK 


* * 
= LOGHODE TABLE FOR CP-CP SESSIONS ON RESOURCES CAPABLE i. 
x OF ACTING AS LU 6.2 DEVICES k -~ 


RAAEKKKRKKKKKKKAKEKKKKKKEKEKEKKEKKARRKKEKKEKEKKAKREKEKKRREKKRKKKKEKEKKKKKEKKEE 


CPSVCMG MODEENT LOGHODE=CPSCVHG, 
RUS IZES=X'8686', ENCR=B'0000'," 
SSNDPAC=7, SRCVPAC=7, PSNDPAC=7 


Figure 47. APPC Logon Mode Entries - APPCMODE.ASM 


Define a link to a partner or intermediate node 


Wa 


1. Define the Token-nng adapter in NCP 


The following 1s a sample token-ring connection from NCP: 
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TO30T2PG GROUP ECLTYPE=(PHYSICAL , ANY) | 
TO30T2PL LINE ADDRESS=(1089,FULL) , LOCADD=?NCPLANADDR?, PORTADD=2, X 
RCVBUFC=4095 ,HAXTSL=2044, ADAPTER=TIC2, TRSPEED=4 


x 


TO30TRLO GROUP ECLTYPE=LOGICAL ,AUTOGEN=10, PHYPORT=2,CALL=INOUT 
Figure 48. LAN definitions on NCP 


2. Provide for use of independent LUs on the token-ring connection 


Once the token-ring 1s defined in the NCP, the only additional parameter that 1s 
required is NUMILU on the LUDRPOOL macro. An example 1s: 


POOL1 LUDRPOOL NUMILU=100, NUMTYP1=20 , NUMTYP2=20 


In this example the NCP will be able to support up to 100 independent LUs 
that are using dial connections (token-nng or switched lines). 


Additional LEN configuration | 
Place the following in a VITAM switched major node definition. It assumes that the 
partner is not another VIAM. If the partner LU is on another VTAM system, then 
the link definitions for the token-ring shown above need to be for a subarea link, or 
the cross-domain links need to be defined so that normal LU routing within the 
subarea network will resolve the locations of the session partners. 


WSN VBUILD TYPE=SHNET ,MAXGRP=2 ,MAXNO=2 
PARTPU PU —sADDR=04, 
CPNAME=?PARTNERLU?, 
PUTYPE=2, 
MAXDATA=2012, 
MAXPATH=1, 
2PARTNERLU2 LU  LOCADDR=0,HMODETAB=?HODETAB? , DLOGMOD=?MODE? 


Figure 49. SYSI.WLAMLSTQVSN) - WSN.VEM 


am >< OK OK OOK 


Configure to run as a client 


Define CPI-C side information 
Create VSAM Dataset for CPI-C Side Information 


The following job creates the VSAM dataset for Common Programming 
Interface-Communications(CPI-C) Side Information. It 1s needed for APPC/MVS 
to be able to initiate TPs that use side information. While it 1s used exclusively 
when APPC/MYS is acting as a client, it 1s included here so that the entry in 
SYS1.PARMLIB(APPCPM00) will reference an existing dataset. Later, side infor- 
mation entnes may be added to it. local volume. 
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//APPCOO2 JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
/*JOBPARM LINES=9999, TIME=1440 
//SISAMPLE EXEC PGM=IDCAMS 
//TSSCO1 DD DISP=OLD,UNIT=3380, VOL=SER=?VOL? 
//SYSPRINT DD SYSOUT=* 
//SYSABEND DD SYSOUT=* 
//AMSDUMP DD SYSOUT=* 
//SYSIN DD * 
DEFINE CLUSTER (NAME(SYS1.APPCSI) - 
VOLUME(TSSCO1) - 
INDEXED REUSE - 
SHAREOPTIONS(3 3) - 
RECORDSIZE(248 248) - 
KEYS(112 0) - 
RECORDS(50 25)) - 
DATA - 
(NAME(SYS1.APPCSI.DATA)) - 
INDEX - 
(NAME (SYS1.APPCSI. INDEX) ) 


Figure 50. JCL for Side Information VSAM dataset - ATBSIVSM.JCL 


CPI-C side information is saved in the VSAM dataset created by ATBSIVSM.JCL. 
Below is a sample job to create a side information entry. 


//STADDO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
Da a a ak 
//STEP EXEC PGM=ATBSDFMU | 
//SYSPRINT DD SYSOUT=* 
//SYSSOLIB DD DSN=SYS1.APPCSI,DISP=SHR 
//SYSSDOUT DD = SYSOUT=* 
//SYSIN ODD * 
STADD 
DESTNAME (?SYMDEST? ) 
TPNAME (2 TPNAME? ) 
MODENAME (? MODE? ) 
PARTNER LU(?PARTNERLU? ) 
Je 
Figure 51. Sample CPI-C Side Information Job - SIADD.JCL 


Other client configuration 


74 


It will not usually be necessary to connect from VITAM out to other nodes. 
However, uf it becomes necessary to do so, a line must be added to the switched 
major node defined above (WSN.VTM). The following line can be added just 
before the LU definition: | 


PATH1 PATH GRPNH=TO30TRLO,DIALNO=?LANADDRESS?, PID=1 
The GRPNM parameter references a group of logical LAN lines defined in the 


NCP. See Figure 48 on page 73 for an example of defining logical LAN lines in 
the NCP. 
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Configure to run as a server 


Define transaction programs 
Create VSAM Dataset for Transaction Program (TP) Profiles 


The following job creates the VSAM dataset for TP profiles. It 1s needed for 
APPC;MVS to be able to associate TP names with particular job streams when an 
incoming request to start a TP is received. volume. 


//APPCOQ1 JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
/*JOBPARM LINES=9999, TIME=1440 
//TPSAMPLE EXEC PGM=IDCAMS 
//VOL1 DD DISP=OLD,UNIT=3380, VOL=SER=?VOL? 
//SYSPRINT DD  SYSOUT=* 
//SYSABEND DD  SYSOUT=* 
//AMSDUMP DD  SYSOUT=*— 
//SYSIN DD =* 
DEFINE CLUSTER (NAME(SYS1.APPCTP) - 

VOLUMES(VOL1) - 

INDEXED REUSE - 

SHAREOPTIONS(3 3) - 

RECORDSIZE(3824 7024) - 

KEYS(112 0) - 

RECORDS(300 150)) - 

DATA - 
(NAME (SYS1T.APPCTP.DATA)) - 
INDEX - 

(NAME (SYS1.APPCTP. INDEX) ) 
a 
Figure 52. JCL for TP profile VSAM dataset - ATBTPVSM.VIM 


Add APINGD to a CLIST library 
If you have the APINGD REXX CLIST, add it to a public CLIST dataset. The 
TP profile example below assumes it has been added to dataset APPC.CLIST. 


Create TP profile for APINGD 
The following job runs the APPC;MVS administrative utility to add a TP profile 
for APINGD. It starts the TSO Terminal Monitor Program IKJEFTO1, which in 
turn calls the REXX CLIST located in the APPC.CLIST dataset. 
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Running APING 
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//TPADDO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1, 1) 
J iS EP EXEC PGH=ATBSDFHU 
//SYSPRINT DD SYSOQUT=* 
//SYSSOLIB DD  DSN=USER.APPCTP,DISP=SHR 
//SYSSDOUT DD = SYSOUT=* 
//SYSIN DD DATA,DLM=Xx 
TPADD 
TPNAHE (APINGD) 
ACTIVE(YES) 
TPSCHED DELIMITER (##) 
TAILOR SYSOUT (NO) 
TAILOR ACCOUNT (NO) 
CLASS (FAST) 
TPSCHED TYPE(STANDARD) 
JCL_DELIMITER(END OF JCL) 
//APPCO4 JOB MSGLEVEL=(1,1),MSGCLASS=A 
//IKJACCNT EXEC PGM=IKJEFTO], 
‘es PARM="EXEC ''?CLIST.DATASET? (APINGD) ''! 
//SYSUADS DD DISP=SHR,DSN=SYS1.UADS : 
//SYSLBC DD DISP=SHR,DSN=SYS1.BRODCAST 
//STEPLIB DD DSN=ISP.V3R2H0.ISPLOAD,DISP=SHR 
//SYSTSPRT DD SYSOUT=* ,FREE=CLOSE 
//SYSTSIN DD DUMMY 
//SYSPRINT DD SYSOUT=* ,FREE=CLOSE 
END OF JCL 
KEEP_MESSAGE_LOG(NEVER) 
## 
XX 
je 
Figure 53. JCL to add a TP profile to the VSAM dataset - TPADD.JCL 


To run APING from TSO enter: 
CALL '2APPC.LOADLIB? (APING) ' '2SYMDEST?'! 


It can also be run from a batch program. Below is a sample job: 


//APINGO JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1) ,NOTIFY=NEALS 
LAO RRC eee ete Ae Rae SORE AEE ae fe oe Pee A ye nt ym Nee DR a 

J STEP EXEC PGM=APING, PARM='?SYMDEST? ' 

//STEPLIB DD DSN=?APPC.LOADLIB? ,DISP=SHR 


// DD DSN=PLI.V2R3M0.SIBMLINK,DISP=SHR 
ie: DD =©DSN=EDC.V2RIMO.SEDCLINK ,DISP=SHR 
//SYSPRINT DD SYSOUT=* 

ba 


Figure 54. JCL to run APING - APING.JCL 


Note: It may be necessary to change the PLI.V2R3MO.SIBMLINK and the 
EDC.V2RIM0.SEDCLINK DD statements to match levels of C and PL;1 on your 


s\stem. 
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How to find ... 
¢ LU name 


For APPC,; MVS, this 1s configured in SYS1.PARMLIB(APPCPMxx). The 
LUADD parameter includes an ACBNAME. The ACBNAME defines an 
APPC MVS LU Name. This name 1s also included on an APPL definition 
statement in an APPL major node of VTAM. 


¢ Control Point (CP) name 


VTAM, being a LEN node, does not have a CP (Control Point) name for 
APPN use. It does, however, have an SSCPNAME (System Services Control 
Point Name). If in configuring a partner platform a CP name is needed, use the 
SSCPNAME instead. It 1s also set in the ATCSTRxx member of the 
VTAMLST dataset. 


¢ Network Name 
It is defined in a member named ATCSTRxx of a dataset with the DDNAME 
of VWTAMLST in the VWTAM start procedure. The “xx” 1s two digits, and the 
default 1s 00. ATCSTRxx is the WIAM start options. The NETID parameter 
defines the network name. 

e LAN address 


The LAN address is coded in NCP on a LINE macro using the LOCADD 
parameter. 
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OS/2 Configuration 


Prerequisites 


Terminology 


This chapter describes how to configure APPC on an OS:2 workstation that 1s con- 
nected to a token nng local area network. It is directed at the following software 
configuration: 


¢ OS.2 EE 1.3 with Networking Services/2 or OS/2 2.0 Extended Services 

¢ Token-Ring Adapter card 
This chapter descnbes how to configure OS/2 on a workstation connected to a 
LAN. For more information: 

© SAA Networking Servicesi2 Administrator's Guide, SC52-1110-00 

© ES OS'2 APPC Programming Referece, S04G- 1025-00 

© ES OS/2 APPN-LU6.2 Connection and Management, SG22-1052-00 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by OS 2. 


Standard Term OS/2 Panel Config OS/2 NDF Term 
Term 


Local Node Name Local LU Name 
Partner LL Name Partner Node Name Partner LU Name 


Local MAC Address NE 
Destination Address 


LAN Destination 


Local LAN Address 
Adjacent LAN Address 


«Address 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by referring to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (7), the middle column describes 
what the vanable is used for and how to determine the value, and the nght-most 
column 1s for you to fill in with a value. Whenever there 1s a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
nght column. 


For example, if vou are following our excellent recommendations, you will write 
#/\ TER in the nght column on the 7A/ODE? line. Then in Figure 62 on page 88 
you will type #INTER on the OS/2 screen that looks hke this: 


Modename ==> #INTER 
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Symbol How to determine the valuc for this symbol Fill in value 
here 


Values that much match with other places 


?LUNAME? This is the symbol that refers to the LU name of the machine 
you are defining to the network. | to 8 character field consisting 
of alphanumenic characters which 1s the LU name of the node. 
Choose a name that 1s unique within the same network name. 
An LU name is defined by defining a CPNAME in OS'2. Refer 
to “How do I Configure a Network?” on page 7 for more infor- 
mation about LU names. 


2?CPNAME? This is the symbol that refers to the Control] Point name of your 
machine. It should be the same as your ?7L UNAME?. Refer to 
“What Is APPN?” on page 6 for more information about 


control points. 


INETWORK? This 1s the symbol that refers to the network name of the 
machine you are defining to the network.’ 1 to 8 character field 
consisting of alphanumenc characters. There 1s a structured 
format for the network name which includes the country code, — 
enterprise code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to “How do I Configure a Network?” on page 7 for more 


information about network names. 


2?PARTNERLU? This 1s the symbol for the partner’s LU name. Refer to the 
“How to find...” section of the partner computer’s configuration 
chapter for this value. Refer to “How do I Configure a 
Network?” on page 7 for more information about the partner 


LU name. 


?PARTNERCP? This is the symbol for the Control Point(CP) name of your 
partner. Refer to the “How to find..” section of the partner 


computer’s configuration chapter for this value. 


This is the symbol for the network name of the partner com- 
puter. Use the network name from the partner computer’s “How 
to find...” section. 


| PARTNERNET? 


This is the symbol for the LAN Address of the partner com- 
puter. (Or the LAN Address of a network node, if the link 1s 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 


27LANADDRESS? 


This is the Transaction Program name. It is a name that 1s sent 
across the network to the server machine. The server machine 
then maps this TP Name to an executable program. The TP 
Name 1s usually specified in a client server product’s documenta- 
tion. For APING, the TP Name on the server 1s APINGD. 


°TPNAME? 


7TPPATH? This is the fully-specified path and filename of the transaction 
program’s executable code. For example, if OS;2 1s installed on 
the C:, drive, this value could be: 


C:\OS2\SAMPLES\APING\APINGD.EXE 
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Symbol How to determine the value for this symbol Fill in value 
here 
?MODE? This 1s the symbol for the mode name. See “What Is a Mode?” 
on page 5 for a discussion of modes. Often, a client;server pro- 
duct’s documentation specifies what mode must be used by that 
product. APING can use any mode (this can be specified on the 
APING command line), but the default is #INTER. It is recom- 
mended that you use one of the architected modes discussed in 
the “What Is a Mode®” section. 


Local values 


2NODETYPE? 


This is the symbol for the APPN node type. This should be EN 
to be configured as an end node, or NN to be configured as a 
network node. In most cases, you will configure as a EN. 


°PLUALIAS? This 1s the symbol for the Partner LU Alias. 1 to 8 characters 
that designates a nickname for the Partner LU. Alias names are 


Case sensitive. 


This it the symbol for the link name of a Jogical link. 1 to 8 
letters or numbers which will be used as a local name on the 
OS 2 machine to refer to the link to a partner computer. You 
can choose any name you like, but since you will use this name 
later to refer to this link, choose a meaningful name. 
(suggestion: LINKOOL) 


TLINKNAME? 


°SYNMDEST? This is the symbol for the CPI-C side information symbolic des- 
tination name. It is any 1-8 character name you choose. It will 
be used locally on the OS‘2 machine to refer to a CPI-C side 


information entry. 


Working with OS/2 Configuration 


Starting/stopping APPC 


APPC is started and ended by starting and stopping Communications Manager. 


¢ Starting: Type “STARTCM”’ from the OS/2 command prompt or mouse click 
on “Communications Manager”. 


¢ Stopping: In Communications Manager, choose ‘Exit’ from the Action Bar. 


Other commands 
¢ Displaying link information: To display link information, choose “SNA Logical 
Links” from the Communications Manager Folder or type “APPNLINK” from 
an OS 2 command prompt. You can also use APPNLINK to activate and 
deactivate links. This command 1s only available in ES OS/2 2.0. 


¢ Displaying active SNA Config Info: To display active configuration informa- 
tion, choose “Display active SNA Configuration’ from the Communications 
Manager Folder or type “APPNLINK” from “PMDSPLAY” from an OS/2 
command prompt to display active configuration information. 
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Configuration 


¢ APPNV.CTL: This file serves two purposes. It gives a description of the node 
definitions file and the format of the commands that can be placed in this file. 
This file also defines the command, parameter, and value names that are 
allowed in the node definitions file. 


Working with APPC configuration 


The following configuration steps will be discussed: — 
1. Define yourself to the network | 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4+. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


OS 2 configuration for APPC/APPN can be accomplished via several methods: 
¢ Panel Configuration for OS/2 2.0 
¢ Text editing a Node Defintions Fide (NDF) for OS/2 1.3 or OS/2 2.0 
¢ Panel Configuration for OS/2 1.3 + NS/2. 


The Panel Configuration facility accomplishes the same function as text editing the 
NDF file and adding the configuration statements. This chapter will discuss both 
Panel Configuration for OS/2 2.0 and NDF file editing for OS/2 1.3+ NS/2 and 
OS 22.0. It will not discuss Panel Configuration for NS/2. 


Your NDF file is located in the \CMLIB\APPN directory. It has the same filename 
as your Communication Manager configuration file whose file extension is “.CFG”. 
However, the NDF file has the fike extension “.N DF”. 


There are example NDF and CFG files provided with this guide called BASE.NDF 
and BASE.CFG. If you wish to configure a machine from with no current config- 
uration. copy the BASE.NDF file tnto the \CMLIB\APPN directory and the 
BASE.CFG file into the \CMLIB directory. If you do not want to lose a current 
configuration, do not copy the BASE files. You can, however, cut and paste the 
commands needed from the BASE.NDF file to your own NDF file. The NDF File 
Configuration instructions show what commands and parameters should be in the 
NDF file. 
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If you wish to use the Panel Configuration for OS/2 2.0, follow the Panel Config- 
uration instructions in this chapter. This method also will place the correct com- 
mands in your NDF file. 


Define yourself to the network 
Before an OS ‘2 machine can communicate on a network, it must define itself to the 
network. This configuration 1s usually done when OS. 2 is installed. 


Panel configuration: 


1. Define LU name You can define (or find if it 1s already configured) your LU 
name in the Local Node Charactenistics panel. 


Follow this sequence of panels: 


-- Select Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type Config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Local Node Characteristics 


Required Features: 

Hetwork ID: ?NETWORK? 
Local node name: ?LUNAME? 
Node type: 

o End Node to Network Node Server 

o End Node - No Network Node Server 

o Hetwork Node 
Your network node server address: ?LANADDRESS? 
Optional Features 

Local Node ID 05D 


Local Node Alias Name 
Comment Configuration is Fun! 


Activate Attach Manager at start up 


Figure 35. Local Node Characteristics. This screen displays the Local Node characteristics 
The LU name is the Local node name on this screen. 


2. Define your node type 


OS 2 can be either an end node or network node. If you choose the End Node 
to Network Node Server and fill in the network node address, a connection will 
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automatically be configured to your network node and you can skip the “Define 
a link to a partner or intermediate node” configuration step. 


NDF file Configuration: 
. Define LU name You can define (or find if it 1s already configured) your LU 
name in the DEFINE_LOCAL CP command in the following Node Defi- 
nitions File excerpt: 


define_local_cp 

fq cp name?NETWORK?.2LUNAME) 
cp_alias(mylu) 

node_1d(x’00000’) 
node_type?NODETYPE?); 


Figure 56. NDF file excerpt from BASE.NDF for DEFINE LOCAL CP. 


2. Define Node Type 
OS 2 can be either an end node or a network node. 
* endnode- ?NODETYPE?=EN 
¢ network node --NODETYPE?= NN 


Define a link to a partner or intermediate node 
A link is configured by defining a connection on the panels or a logical link in the 
NDF file. 


Panel configuration: 
1. To define a link, follow this sequence of panels: 


-- Communications Manager from the 08/2 Window List 
-- Advanced 
-- Configuration. type configuration file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Connections 


2. A list of nodes will be display. Select the type of node you are connecting to: 
e Network Node - choose Network Node 
e Partner Node - choose Peer Node 


¢ Host Node - choose Primary Host > 
3. Select the type of connection you desire (e.g. IBMT RNET for token-nng) 


4+. The screen, “Creating a Connection to a Peer Node” will be shown. Fill in the 
appropnate values from the Required Values Table 
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Creating a Connection to a Peer Hode - ESBASE 


Link Name: ?LINKNAHE ? 
Partner network ID: 2PARTNERNET ? 
Partner node name: ?PARTHERLU? 
LAH destination address: ?LANADDRESS? 
Comment: 


Figure 57. Creating a Connection. This screen displays the parameters for defining a con- 
necuon to a peer node. 


NDF file Configuration | 
Define a link to the network node: To define a link to your network node, your 
Node Definitions File should contain a “define_logical_ link” command, 


define_logical link 
link name(?7LINKN AME?) 
adjacent_node_type(learn) 
preferred_nn_server(yes) 
dic name(ibmtmet) 
adapter_number(Q) 
destination_address(x’7>LANADDRESS”) 
Cp_cp_session_support(yes) 
activate_at_startup(yes); 


Figure 358. NDF file excerpt from BASE.NDF for DEFINE LOGICAL LINK for 


network node link. 


Define a link directly to your partner or to a LEN node.: To define a link directly 
to your partner, your Node Definitions File should contain a “define_logical_hnk” 
command lke this: 


define logical link 
link name(?LINKNAME?) 
fq_adjacent_cp name(?7PARTNERNET?.2PARTNERCP?) 
adjacent_node_type(learn) 
dic _name(ibmtrnet) 
adapter number(0) 
destination_address(x >LANADDRESS”) 
cp_cp_session_support(no) 
activate _at_startup(no); 
solicit_sscp_session(no); 


Figure 59. NDF file excerpt from BASE.NDF for DEFINE_LOGICAL LINK for partner 
link. 
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For a link to a host LEN node that requires 3270, the following define_logical_link 
parameter should be changed to yes. 


solicit_ sscp_session(yes); 


Also, to configure 3270 sessions the 7LANADDRESS? should match the Desination 
Address in 3270 Feature Profile Connections. 


Additional configuration | 
Define partner LU’s: When the partner LU is NOT accessible through a NN, as in 
a LEN node connection or a direct link to your partner, you must define the path 
to the partner LU. 


For your machine to be able to locate the partner LU, a correlation between your 
link definition and the partner LU must be established. This is done by associating 
the partner LU to a particular link. 


Panel configuration: Follow this sequence of panels: 


-- Communications Manager from the OS/2 Window List 
-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Connections 
-- Link Name defined above for the host or partner connection 
-- Define Partner LU's 


To add a Partner LU, enter the LU name, alias, and comment. Then select 
Add button. 


To change a4 Partner LU, select and LU from the list, change the LU name, 
and/or Comnent fields and select the Change button. 


To Delete a Partner LU, select an LU from the list and select the Delete 


LU name Alias 
LU name: ?PARTHERLU? ?PARTNERLU? ?PLUAL IAS? 
Alias: ?PLUALIAS? 
Comment: UNC #1 


Figure 60. Partner LL. This screen displays the Partner LU parameters. 


NDF file Configuration: 
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define_partner_lu 
fq partner lu_name(?PARTNERNET?OPARTNERLU?) 
descnption(partner lu for appc on the host) 
partner_lu_alias(?7PLUALIAS?) 
partner _lu_uninterpretred_ name(?PARTNERLU?) 
max_mc_ll send_size(32767) 
conv_security_venfication( NO) 
parallel_session_support(YES); 


define_partner_lu_location 
fq_partner_lu_name(?PARTNERNET?.2PARTNERLU?) 
wildcard_entry(NO) 
fq owning cp name(?PARTNERNET?.2-PARTNERCP?) 
local node_nn_server(NO); 


Figure 61. NDF file excerpt for define_partner_lu and define _partner_lu_location. 


Configure to run as a client 


Define CPI-C side info entry 
APING and many other applications do not require CPI-C side information. Refer 
to -- Heading “CVRSPIC’ unknown -- for a discussion fo CPI-C side info entnes. 
If you wish to use a symbolic destination name as the target of a conversation, you 
must define a CPI-C side info entry. 


Panel Configuration: Follow thissequence of panels: 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Additional SNA Features 
-- CPI-C Communications Side Info 
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Creating a Side Information - 


Partner LU 


o Fully qualified name 2PARTNERHET ?. 2PARTHERLU? 
o Alias 2PLUALIAS? 


Partner TP 


_ Service TP 
TP name: ?TPNAME? 


Security Type 
o Same o None o Program 
Hode Name: 2MODE ? 


Comment: 


Figure 62. CPI-C Side Info. This screen displays the CPI-C Side Information parameters. 


NDF File Configuration: To define a CPI-C side info entry, your Node Definitions 
File should contain a “define_cpic_side_info” command, 


define_cpic_side_ info symbolic_destination_name(?SYMDEST?) 
fq partner lu_name??PARTNERNET?.2PARTNERLU?) 
mode_name(? MODE?) 
tp_name(7TPNAME?); 


Figure 63. NDF file excerpt for defining a CPI-C side info entry. 


Other Client Configuration 
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Define Partner LU Alias: An additional feature of defining partner LUs 1s that you 
can provide an alias for the actual partner LL name. For example, you could 
define SERVER to be an alias for PARTNERNET.PARTNERLU. Alias’s are 
case sensitive; SERVER is a different alias than “server.” 


If you choose to define partner LUs, either to provide an alias for use when running 


a client program, or to restrict the names of partner clients that can contact you, use 
a “define_partner_lu” command as follows in the NDF: 


Panel configuration:: Follow the below sequence of panels: 


Mult-platform APPC Configuration Guide 


-- Communications Manager from the 0S/2 Window List 


-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 


-- Connections 
-- Link Name defined above for the host connection 


-- Define Partner LU's 


Creating a Partner LU - ESBASE 


Fully Qualified 

LU name: 2PARTNERNET 2. 2PARTNERLU? 
Alias: 2PLUALIAS? 
0 Conversation security verification 


Comment: 


Figure 64. Partner LU. This screen displays the Partner LU parameters. 


NDF File Configuration: 


define_partner_lu 
fq partner lu name(??PARTNERNET? 2PARTNERLU?) 


partner_lu_ahas(?P LUALTAS?,?plualias?); 


Note: Because the alias is case sensitive, 18 1s recommended that you 
define the alias (PLUALIAS) in both upper and lowercase. This can only be 
done in the NDF file as in the example above. 


Figure 65. NDF file excerpt for Partner LU.. 


Configure to run as a server 


Define transaction programs 
To run OS/2 as the target of a conversation, you must, in addition to the common 


configuration steps above, define a TP on your machine that will be the target 
program of the conversation. 


Panel configuration:: Follow this sequence of panels: 
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-- Communications Manager from the 0S/2 Window List 


-- Advanced 
-- Configuration, type config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Additional SNA Features 
-- Transaction Program Definitions 


Creating a Transaction Program 
Options: 
Conversation security required _ Service TP 


Transaction Program (TP) name : 2T PHAME 7 


0S/2 program path and file name: 2TPPATH? 


Program parameter string : see note 1 below 
Icon path and file name 


Comment 


Figure 66. TP definition. This screen displays the TP definition parameters. 


Click on the ‘Continue’ button and see see note 2 below for TP program operation 
parameter. 


NDF File Configuration: To define a transaction program to your network node, 
your Node Definitions File should contain a “define_tp” command, 


define_tp 
tp_name(7TPNAMME?) 
filespec(7 TPP ATH?) 
parm_stning() see note 1 below . 
tp_operation(nonqueued_am_ started) see note 2 below 


program type(vio_windowable); 


Figure 67. NDF file excerpt from BASE.NDF for DEFINE_TP. 


Notes: 


1. Parameter string 


Any command line parameters that need to be run with the program are entered 
here. 


2. TP program operation 


This parameter indicates how the local TP is started as a server. It can be one 
of the following: 


* QUEUED OPERATOR STARTED 
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* QUELED OPERATOR PRELOADED 
- QUELED_AM STARTED 
* NONQUEUED_AM STARTED 


Other Server Configuration 


Since both Extended Services and Networking Services/2 support APPN, you do 
not need to define partner LU names. The partner LU can be located through 
APPN services. 


When inbound implicit partner LU support is enabled, the computer has the capa- 
bility to accept an incoming BIND request that contains a partner LU name that 1s 
not defined at the local node. To enable any partner to call you when your com- 
puter 1s a server, make sure your Node Definitions File contains the following: 


define_defaults 
implicit_inbound_plu_support(yes); 


Figure 68. NDF file excerpt for implicit_inbound_plu_support. 


Note: The implicit_inbound_plu_support cannot be changed from the panel config- 
uration. 


Verifying configuration 


You must verify the changes you make to the configuration by using one of the 
following methods. 


¢ Panel configuration: Choose Venfy from the action bar to venfy and update 
your configuration. Answer “Yes” to “Do you want to update active configura- 
tion?” 

¢ Panel Configuration: Choose the Venfy icon from the Communications 
Manager Folder 


¢ NDF Configuration - Run the following ‘appnv’ command from the OS/2 
Command prompt with the /e option to venfy and update your configuration. 
Type APPNV, then vour NDF file name. 
‘appnv <NDF file name >.NDF’ 


You should stop and restart Communications Manager to make changes active. 


OS,2 Configuration 9] 


Running APING 


Run the APING executable from the OS/2 Command prompt with the following 
parameters: 


¢ Parameter = 9PARTNERNET?2PARTNERLU? or ?PLUALIAS? or 
2SYMDEST? 


¢ Options = Any options flags you wish to run with APING. Type ‘APING ” 
for list. 7 


APING ?PARTNERNET?. ?PARTNERLU? 


How to find... 


Panel Configuration 
¢ LU name 


You can find your local LU in the Local Node Charactenstics panel. 


-- Communications Manager from the 0S/2 Window List 
-- Advanced 
-- Configuration, type Config file name and press ENTER 
-- SNA feature profiles 
-- SNA Network Definitions 
-- Local Node Characteristics 


The LU name 1s the Local Node Name on the panel. 
e CP name 

The CP name is the same as the LU name found above (Local Node Name). 
e Network Name | 

The Network Name is the Network ID 1n the above panel. 


¢ local LAN address - cannot be found in the panels 


NDF File 


« LU name 


You can find your LU name in the DEFINE_LOCAL_CP command in the 
following Node Definitions File excerpt: 
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define local cp 
fq cp name(?NETWORK?.2LUNAME?) 
cp_alias(mylu) | 
node_id(x ?NODEID”) 
node_type(en); 


Figure 69. NDF file excerpt from BASE.NDF for DEFINE LOCAL _CP. 


The LU name is LUNAME. 
e CP name 

The CP name is the same as the LU name found above. 
e Network Name 


The Network Name is the NETWORK vanable in the excerpt of the 
DEFINE _LOCAL_ CP command. 


* local LAN address 


The LAN address 1s a 12-digit hexadecimal value that identifies your token-nng 
adapter to the network. There 1s a LAN address hard-coded on the Token- 
Ring adapter in the NS’DOS machine. This hard-coded value is sometimes be 
over-ndden with something called a “locally administered address.” You can 
find your LAN address in the following ways. 


— Check the computer’s IBMCOM\LANTRAN.LOG file if you are using 
OS,2 2.0. or in the \CMLIB\ACSLAN.LOG file if you are using OS,2 1.3 
+ NS 2. You will see a line that says: 


Adapter X has node address ‘“LANADDRESS’ The value in 
LANADDRESS 1s your local LAN address. 


— Run diagnostics on the computer’s reference diskette: 
1. Boot the machine on its reference diskette 
2. Press Enter to clear the main panel 
. Press Ctrl+ A to start advanced diagnostics 
. Select “System checkout” 
Press “Y” to indicate the list 1s correct 
Select “Run tests one time” 
. Cursor down to the “Pnmary Token-Ring Adapter and press Enter 


. Select the proper cable type 


. Press enter on the panel asking you to disconnect your cable (you don’t 
actually need to disconnect it for this exercise) 


10. Press enter when told the next screen will contain important informa- 
tion 


11. On the information screen, the value after Adapter Address is you LAN 
address (you may need to Page Down to see this value). 
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12. After making note of the Adapter Address, remove the reference 
diskette, reconnect your cable if you disconnected it, and press Ctrl-Alt- 
Delete to reboot your machine. 


94 Mulu-platform APPC Configuration Guide 


APPC/VM Configuration 


Prerequisites 


Terminology 


This chapter describes how to configure APPC:VM. The configuration is spread 
among the APPC:VM VWTAM Support service machine (AVS), VTAM, and NCP. 
Examples of configuration of each are shown. 


Software and hardware prerequisites for APPC/VM include: 
¢ VM ESA V1.0 or later 
¢ VITAM V3.3 or later 
¢ NCP V5.2 or later 
© 3745 with Token-nng attachment 
e Single SNA domain. 
It also assumes that the software listed above has already been installed on the 
appropnate hardware platforms. 
For more detailed information on APPC/VM configuration and operation refer to: 
© VALESA Connectivity Planning, Administration, and Operation, SC24-5448 
¢ TAM Resource Definition Reference, SC31-6438 


© NCP Resource Definition Reference, SC30-3448 


The terminology table maps the standard networking terms defined in “How do I 
Configure a Network?” on page 7 to the terms used by APPC/VMI. 


Standard Term APPC/[VM Term 


LU Name name supplied for APPL definition in 
APPL major node 

Partner LU Name name supplied for LU definition in 
major nodes other than APPL 

Local LAN Address LOCADD (in NCP gen) 


Adjacent LAN Address DIALNO (on PATH definition in 
switched major node) 


APPC/VM Configuration Worksheet 


Use the following table to determine all the values you will need while configuring 
this platform. The table is split into two parts: values determined by refernng to the 
Booklet introduction or other platform chapters, and values local to this platform 
that you make up. There are three columns. The left-most column has a variable 
name that starts and ends with a question mark (?), the middle column describes 
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what the variable is used for and how to determine the value, and the nght-most 
column is for you to fill in with a value. Whenever there is a reference in this 
chapter to a value in the left column, substitute the value you have wnitten in the 
nght column. 


How to determine this value Fill in value 
here 


Values that much match with other places 


?LUNAME? This is the symbol that refers to the LU name of the machine 
vou are defining to the network. 1 to 8 character field consisting 
of alphanumenic characters which is the LU name of the node. 
Choose a name that 1s unique within the same network name. 
Refer to “How do I Configure a Network?” on page 7 for more 
information about LU names. 


You may already have an LU name defined. If so, it 1s the value 
specified in an “AGW ACTIVATE GATEWAY’ command. 
This command can be included in the AGWPROF GCS exec of 
the AVS service machine, or it can be issued from the AVS 
console. 


You may also have more than one LU. There are two major 
types of gateways in APPC;VM; global and pnvate. If you want 
to use both you will need a minimum of one LU for each type. 
See “Configure to run as a server” on page 104 for more infor- 
mation on gateways. A private gateway will be referred to by 
°LUNAME_ P?. while 4 global gateway will be called 
°LUNAME G?. | 


27CPNAME? VTAM pnor to V4 does not have a control point. Refer to 
“What Is APPN®” on page 6 for more information about 


control points. 


INETWORK? This is the symbol that refers to the network name of the 
machine you are defining to the network. 1 to 8 character field 
consisting Of alphanumenc characters. There 1s a structured 
format for the network name which includes the country code, 
enterpnse code and network suffix code. This format insures 
uniqueness around the world. Call your local IBM branch office 
for the format information and to register your network name. 
Refer to “How do I Configure a Network?” on page 7 for more 


information about network names. 


For systems with VTAM already configured, this value is found 
in the VTAMULST start options (ATCSTRxx) member. The 
option name 1s NETID. 


?PARTNERLU? This is the partner's LU name. Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. Refer to “How do I Configure a Network?” on page 7 


for more information about the partner LU name. 
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Symbol How to determine this value Fill in value 
| here 


°LANADDRESS? | This is the symbol for the LAN Address of the partner com- 


puter. (Or the LAN Address of a network node, if the link 1s 
being made to a network node.) Refer to the “How to find...” 
section of the partner computer’s configuration chapter for this 
value. 


This is the symbol for the Transaction Program name. This 1s 
the name of the transaction program at the partner computer. 
For APING, the TP Name on the server is APINGD. 


7EPNAME? 


When using private gateways, an entry 1s made in the 
$SERVER$ NAMES file that maps the TP name to an EXEC 
or module. The actual TP name follows a ’:nick.” parameter in 
the file. 


This is the symbol for the mode name. Sce “What Is a Mode?” 
on page 5 for a discussion of modes. Often, a client/server pro- 
duct’s documentation specifies what mode must be used by that 
product. APING can use any mode (this can be specified on the 
APING command line), but the default is #INTER. It is recom- 
mended that you use one of the architected modes discussed in 
the “What Is a Mode?” section. 


2? MODE? 


Local values 


INCPLANADDR? | This is the local LAN address coded in NCP on a LINE macro 
using the LOCADD parameter. 


YMODETAB? 


Name of a logon mode table in VTAM. It is assembled and link- 
edited into a VTAM LOADLIB dataset. The systems pro- 
yrammer should know the names of the logon mode tables 
defined on the system. This should be the name of the table 
where the APPC modes are included. 


TSYMDEST? 


This is the CPI-C side information symbolic destination name. 
It is any 1-8 character name you choose. It 1s included when 
creating a side information entry. The side information is stored 
in communications directory files which are similar to NAMES 
files. 


Working with APPC/VM 


Starting/stopping APPC 


APPC/VM is usually started by autologging the AVS. VM virtual machine. It can 
also be started by issuing AGW START once GCS 1s ipled in the AVSVM 
machine. Stopping APPC;VM 1s accomplished via the AGW STOP command. 
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Other commands 


APPC;VM is a VTAM application that runs in its own disconnected virtual 
machine (typically AVSVM) under GCS. Once APPC/VM is logged on there are 
several commands that can be used to monitor its operation. A subset of these com- 
mands is shown below: 


AGW QUERY ALL 
AGi! CNOS 
AGW ACTIVATE GATEWAY 


The QUERY ALL command provides a listing of all resources in use by 
APPC, VM. AGW CNOS wil negotiate session limits with partner LUs. ACTI- 
VATE GATEWAY makes an LU available to APPC/VM for its own use. 


Configuration 
Working with APPC configuration 


The following configuration steps will be discussed: 
1. Define yourself to the network 
2. Define a link to a partner or intermediate node 
a. Additional LEN configuration 
b. Other link configuration 
3. Configure to run as a client 
a. Define CPI-C side information 
b. Other client configuration 
4. Configure to run as a server 
a. Define transaction programs 


b. Other server configuration 


For APPC; VM, configuration is done in the following places: 
¢ AVSVM DIRECT - The directory entry for APPC/VM. 


¢ AGWPROF GCS - This exec is called by AVSVM during startup. It starts 
_ resources for AVS; VM. 


¢ Server commands - Certain commands are issued in any virtual machine that 
wil be used as a server. 


¢ COMDIR - For client virtual machines, the communications directory must be 
established for CPI-C applications with the SET COMDIR command. 


¢ $SERVER$ NAMES - For server virtual machines, this file contains the 
mapping of transaction program names to executables. It 1s used only with 
private gateways. 


¢ VWTAM - Definitions are required in an application major node for the 
APPC; MV S LU or LUs, as well as partner definitions in a switched major node 
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for LAN attached T2.] nodes, such as workstations. Additions are also need in 
logon mode tables for APPC modes. 


¢ NCP - The token-nng adapter must be configured, and a parameter added to 
the NCP definition to support independent LUs. 


Define yourself to the network 


1. Create CP Directory Entry for the APPC/VM VTAM Service Machine 


APPC services in VM access an SNA network through the APPC/VM VIAM 
Service Machine (AVSVM). AVSVM’s directory entry should look similar to 
the one shown below: 


USER AVSVH AVSVM 32M 64M G 64 


x 


ACCOUNT 1  AVSVMH 
MACH XA 
TUCV ANY 
TUCV *IDENT GATEANY ?LUNAME? REVOKE 
TUCV ALLO! 
OPTION COMSRV MAXCONN 20 ACCT 
NAFESAVE GCS 
IPL GCS PAR AUTOLOG 
CONSOLE O1F 3215 
SPOOL OO0C 2540 READER A 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 
LINK HAINT 190 190 RR 
LINK MAINT 19D 19D RR 
Lifin FAINT 196 iS RR 
dK HAINT 193 193 RR 
HOISK 191 3380 2209 003 SSKNO5 MR RAVSOBJ WAVSOBJ MAVSOBJ 


Figure 70. CP Directory Entry for AVSVM - AVSVM.DIR 


2. Load AVS from the Product Tape 
This step is described in the V\7/ESA Installation Guide, SC24-5526. It 1s done 
by issuing the command: 
vmfins install ppf esains avs (nomemo nolink 
It is strongly recommended in the VM/ESA Installation Guide that none of the 


disk addresses in the user directory be modified. The directory entry shown 
above is the entry shipped with VM/ESA. 


The example above is for installation on mini-disks. It may be advantageous to 
install AVS in the shared file system (SFS): For more information on this, see 
both the VM/ESA Installation Guide and VM/ESA: CMS Planning and Admin- 
istration Guide, SC24-544S. 


3. Create the AVS Virtual Machine Profile and AGWPROF GCS. 


The PROFILE GCS contains commands to start AVS when the virtual 
machine 1s started. It is stored on the AVS 191 disk. AGWPROF GCS its 
called after AVS initialization, and contains commands to execute as soon as 
AVS 1s available. Samples of each are shown below. 
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[EO ne TOI Eg ES ee, eRe a tee a ete Renee ee Bare, 


i */ 
/* SAMPLE PROFILE GCS FOR AVS | “) 
7? */ 


IG Ra er net Rm Re eee ron ea Re ION Ry eee ne eee aes Re RN 


Trace 0 

'CP SET IMSG ON! 

'CP SET EHSG ON! 

'CP SET RUN ON! 

'CP SET PFO] IMMED AGW QUERY ALL' 

‘CP SET PFO2 IMMED AGW QUERY GATEWAY ALL' 
'CP SET PFO3 IMMED AGW QUERY CNOS ALL' 
'CP SET PFO4 IMMED AGW QUERY USERID ALL' 
'CP SET PFO5 IMMED AGW QUERY CONV ALL! 
'CP SET PF12 RETRIEVE' 


ECO COSCO II IIIS IIIS IT ETO IIIT IIE IIT TTI TTT TITER | 
fe ay 
/* Determine mode of operation. Load AGW370 loadlib if running */ 
/* in 370 mode. Load AGW LOADLIB if running in XA mode. - 


JS he RT GEA Lae ge Rn a Oma ee eet tem ae ne ee Ne oar Ce 


'GLOBAL LOADLIB AGWUTIL' /* Contains AGWGMD ois 
'OSRUN AGWGHD! /* AGWGMD returns © if running in XA mode, 
and 4 if running in 370 mode * / 
IF RC=0 THEN /* Virtual machine is in XA mode ay 
‘GLOBAL LOADLIB AG\!' 
ELSE 
'GLOBAL LOADLIB AGW370' /* Virtual machine is in 370 mode a 
'LOADCHD AGW AGW! 
'Q LOADLIB! 
'Q LOADCMD' 
"AG! START! /* Start AVS a 
exit rc 


Figure 71. PROFILE GCS - PROFILE.GCS 


KEKKKKEAKKEKKKREREKKEEKEKEK 


/* AGWPROF GCS FOR AVS */ 


Ya a a aay | 

"AGH! ACTIVATE GATEWAY 2LUNAME_P? PRIVATE’ 
‘AG! ACTIVATE GATEWAY 2?LUNAME_G? GLOBAL' 
Figure 72. AGWPROF GCS - AGWPROF.GCS 


Notes: 


a. The names substituted for 7 LUNAME? should be different. 72 LUNAME? 
was used to designate both since they are both local LUs. 


Gateways define paths (Logical Units or LUs) into the SNA network. As such 
these names must match names of LUs defined in a VWITAM application major 
node described below. 


4. Create VITAM Application Major Node -- 
Place the following in a VTAMULST library (usually SYSI.WTAMLST): 
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* 


APLAVS  VBUILD TYPE=APPL 

?LUNAHE G? APPL APPC=YES, 
AUTHEXIT=YES, 
AUTOSES=1, 
DSESLIM=8, 
DHINWNL=4, 
DHINWNR=4, 
PARSESS=YES, 
SYNCLVL=CONFIRM, 
SECACPT=ALREADYV 

7LUNAME_P? APPL APPC=YES, 
AUTHEXIT=YES, 
AUTOSES=1, 
DSESLIM=8, 
DHINWNL=4, 
DHINWNR=4, 
PARSESS=YES, 
SYNCLVL=CONFIRM, 
SECACPT=ALREADYV 


am OK OK OK KOK OOK OOK 


~< KOK OK KO OK OX 


Figure 73. VIPANI definition of APPC LU - APPLVM.VTMI 


Notes: 


a. The names substituted for 7LUNAMIE? should be different. ?LUNAME? 
was used to designate both since they are both local 


b. If a logon mode table other than the default table ISTINCL™M) will 
contain the APPC mode entnes, a NODETAB parameter should be added 


to the entnes above. LUs. 


c. Depending on secunty requirements on the VM system, the SECACPT 


parameter may also need to be changed. 


5. Add APPC Modes to the Logmode Table 


APPC modes are shown in Figure 74 on page 102. Add them to vour logmode 
table, compile, and then link-edit the member into a VTAM library. Also 
include them in the default logmode table (ISTINCLM) so that dynamically 


created LUs can use them. 
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HREREKEEREEKREREREEKERKERREERKKKKKRKRKEKEKEKRKREKEKRKKKERKKKEEREEKRREKERAKREERERR 


s LOGHODE TABLE ENTRY FOR RESOURCES CAPABLE OF ACTING * 

* AS LU 6.2 DEVICES * 

KEKKKEKKEEKAEEKAEEKEKKEEERERKKKEKKRKKEKKEEKEKKEKEERKEEKEEKREKEKEKREREREREREERRE 

SHASVCHG HODEENT LOGMODE=StIASVCNG, FHPROF=X'13', TSPROF=X'O7", * 
PRIPROT=X'BO', SECPROT=X'BO', COMPROT=X'DOB1', * 
-RUSIZES=X'8686' , ENCR=B'0000', SSNDPAC=7, * 
PSERVIC=X'060200000000000000000300' , ‘ 
SRCVPAC=7, PSHDPAC=7, TYPE=0 

TITLE ‘#BATCH' 
REKKKRAEKEREKERKEKKRAKKKKEKKEKEKRERKEKAKKEKKRRERRARRREKRERKEKKKEKKKEEKRRERREEKREK 
x r 
‘ LOGHODE TABLE FOR BATCH SESSIONS ON RESOURCES CAPABLE ‘ 
. OF ACTING AS LU 6.2 DEVICES : 
* * 
KKEAKAKARKERRERAKKKKEKAKKKKEAKKKKEKKKEKERKEKKKRARKRKERKKAKKRKEKEKKERKRREKKKRKKEREKK 
#BATCH MODEENT LOGHODE=#BATCH, * 

ENICR=B'0000', SSNDPAC=3, ‘ 
SRCVPAC=3, PSNDPAC=3, RUSIZES=X'F7F7' 
TITLE '#INTER' 
KEKE KKEKAEKRKEKARKEKEREKARKKKRKKKKAEKKERKKKKKKEREKKEKEKKKEKKKKKEKKKKRREREKREREKEK 
bd * 
* LOGHODE TABLE FOR INTERACTIVE SESSIONS ON RESOURCES ‘ 
* CAPABLE OF ACTING AS LU 6.2 DEVICES ' 
* x 
RHARAAMAEKKKAKKKKEKKKKEKKKEKKKEKKKKAKAKKRERKKKKKKEKKKKKKEKKKEKKAKRKEKERAKRKRERERERREE 
#INTER MODEENT LOGHODE=#INTER, * 
ENCR=B'0000' , SSIIDPAC=7, ‘ 
SRCVPAC=7, PSNDPAC=7, RUSIZES=X'F7F7' 

TITLE '#BATCHSC' 
RAKKKKEKERREKEKEAKKKKKKKEKKKKKKKAKKEKAKKKRERKKRAKKAEKKEKKKEKEKRKEKKERKKREEEE 
* x 
* LOGHODE TABLE FOR BATCH SESSIONS REQUIRING SECURE ‘ 
. TRANSPORT Ol! RESOURCES CAPABLE OF ACTING AS LU 6.2 * 
* DEVICES * 
* x 
KRAEAEKKKAKEKAKKEKKKEKOEREKREKKKAEKKKKKKRKAKKKKEKKAKKRKKKKKKKRKKKKKKKKRERKKKKERK 
#BATCHSC HODEENT LOGHODE=#BATCHSC, * 

ENCR=B'0000', SSHDPAC=3, * 
SRCVPAC=3, PSNDPAC=3, RUSIZES=X'F7F7' 

TITLE ‘#INTERSC' 
KRAAEKKKAEKRARKRKRERKRRAKKRKKEKARAKKKKKKKKKKKKEKRAKKKERKKREKAKKAERKKEKKKEKKKKRKAER 
* * 
* LOGHODE TABLE FOR INTERACTIVE SESSIONS REQUIRING ‘ 
- SECURE TRANSPORT ON RESOURCES CAPABLE OF ACTING AS . 
* LU 6.2 DEVICES ; 
* * 
KARA ERKAAKEARRERALAKRKRMEP REE AKEKAKRRAKKKKKKEKKAKKKKKEKREKRKKEKKERAEKKAKKRKKERREREK 
#INTERSC MODEENT LOGHODE=#INTERSC, * 

ENCR=B'0000' , SSHOPAC=7, * 
SRCVPAC=7, PSHDPAC=7, RUSIZES=X'F7F7" 

TITLE 'CPSVCHG' 

RRA KKARAEKAEKRKKRERKEKRKRKEKKKERKKKEEKKKKREKKKKKEKKKAKKAKKKEKEKRRKKKREKKEKKKKARKRKE 
x * 
* LOGHODE TABLE FOR CP-CP SESSIONS ON * 
, RESOURCES CAPABLE : 
* OF ACTING AS LU 6.2 DEVICES * 
* * 
RREKKKKKKKEEERARAKKKKAKRKKKAKKKKEKEKEKKAKKAERKKEKAKERRRKKKKKEEKRAEKKEKREKRKEKKKEKK 
CPSVCHG HMODEEIIT LOGHODE=CPSCVNG, * 

RUSIZES=X'8686' , ENCR=B'0000', “ 


| SSHIDPAC=7, SRCVPAC=7, PSHDPAC=7 
Figure 74. APPC Logon Mode Entries - APPCMODE.ASM 
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Define a link to a partner or intermediate node 
1. Define the Token-nng adapter in NCP 


The following is a sample token-nng connection from NCP: 


TO30T2PG GROUP ECLTYPE=(PHYSICAL, ANY) 
TO3OT2PL LINE ADDRESS=(1089,FULL) ,LOCADD=?NCPLANADDR?, PORTADD=2, X 
RCVBUFC=4095 , MAXTSL=2044 , ADAPTER=TIC2, TRSPEED=4 


x 


TO3OTRLO GROUP ECLTYPE=LOGICAL ,AUTOGEN=10, PHYPORT=2,CALL=INOUT 
Figure 75. LAN definitions on NCP 


2. Provide for use of independent LUs on the token-nng connection 


Once the token-ring is defined in the NCP, the only additional parameter that is 
required is NUMILU on the LUDRPOOL macro. For example: 


POOL1 LUDRPOOL NUMILU=100,NUMTYP1=20 , NUMTYP2=20 


In this example the NCP will be able to support up to 100 independent LUs 
that are being connected via dial connections (token-nng or switched lines). 


Additional LEN configuration 
Place the following in a VTAM switched major node definition. It assumes that the 
partner node 1s not another VITAM. If the partner LU is on another VWIAMNI system, 
then the link definitions for the token-nng shown above need to be for a subarea 
link, or the cross-domain links need to be defined so that normal LU routing within 
the subarea network will resolve the locations of the session partners. 


WSN VBUILD TYPE=SWNET ,HAXGRP=2 ,MAXNO=2 
PARTPU PU —s ADDR=04, 
CPNAME=?PARTNERLU? , 
PUTYPE=2, 
MAXDATA=2012, 
MAXPATH=1 
2PARTNERLU? LU  LOCADDR=0,MODETAB=?MODETAB? , DLOGMOD=?MODE? 


Figure 76. WSN.VTIM 


>< OK OK OO 


PARTNERLVU should be changed to match the partner LU name. See the “How to 
find...” section of the partner computer's configuration chapter for this value. 


Configure to run as a client 
Place the APING MODULE and APINGD MODULE on a minidisk to which 
you have access. 


Define CPI-C Side Information 
In APPC;VM side information 1s stored in what 1s called a comununications direc- 
tory. Itis a WMI file similar in definition and use to VM NAMES files. Below is a 
sample entry: 


snick.?2SYMDEST?  :APINGD 
:luname.?LUNAHE? ?PARTNERLU? 
:modename. ?7MODE? 
:security.NONE 


Figure 77. Sample Communications Directory Entry - COMDIR.SMIP 
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If this entry is included in a VM file called SAMPLE COMDIR then it can be acti- 
vated in the client virtual machine by issuing: 


SET COMDIR FILE USER SAMPLE COMDIR 


More information on this command can be found by looking at the online help text 
for SET COMDIR. 


Configure to run as a server 
1. Place the APINGD EXEC or APINGD MODULE on a public minidisk. 


2. Configure the Virtual Machine to nn APINGD 


There are two principle methods of execution for transaction programs in 
APPC/VM; as global resources or as private resources. A global resource can be 
thought of as a resource or program available to a number of users, while a 
private resource or program is run within a particular users virtual machine. 
Which type is used by APPC/VM on incoming requests is determined by the 
type of gateway; if a global gateway is used, the transaction program is sched- 
uled as a global resource, while if a private gateway is used the transaction 
program is assumed to be private. Gateways are APPC/VM LUs. 


Configuring a Global Gateway: A global resource must be registered as such with 
VM. There are two ways to do this. First, an entry can be added to the directory of 
the virtual machine owning the resource, as is shown below: 


IUCV *IDENT resrcl GLOBAL 


This will identify resrel as a resource managed by the virtual machine in which it 1s 
included. 


The other way is to use the Identify_Resource_Manager (ACIDR™M) call. This call 
can be used from within a program or EXEC to register the resource with VM. 
This still requires an additional directory entry similar to the one below: 


TUCV *IDENT RESANY GLOBAL 


The “RESANY’” parameter allows the resource manager virtual machine to register 
any resource name using the XCIDRM call. Below 1s an EXEC called 
RESAPING which registers a resource called APINGD as a global resource, and 
then waits for events (such as an incoming attach) to schedule the transaction 
program. 7 
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pry 
/* ARG resid */ 
‘set Idrtblis 20' 
‘rtnload * (FROM VMLIB SYSTEM GROUP VMLIB) ' 
‘global loadlib edclink' 
‘GLOBAL TXTLIB EDCBASE IBMLIB CHSLIB CHSSAA' 
resid = word(resid userid(), 1) 
original resid = resid 
‘EXECIO * DISKR CMREXX COPY * (FINIS STEM CPICONST. ' 
if rc<>O0 then exit rc 
do i=] to cpiconst.0 
interpret cpiconst.i 
end 
JP TRACE a" 47 
server scope=XC_GLOBAL 
service mode=XC_ SEQUENTIAL 
secnone=XC_ACCEPT SECURITY NONE 
address cpicomm 
RESID='APINGD ' 
'XCIORM RESID SERVER SCOPE SERVICE MODE SECNONE IDSRV_RC' 
IF IDSRV_RC <> O & IDSRV_RC <>24 THEN DO 
SAY ‘Unable to start resource’ RESID 
exit idsrv_RC 
end 
do forever 
say ‘Waiting for ALLOCATION event, TERMINATE, STOP or CHS command ' 
'XCVOE resid conversation_id event length buffer WOE_rc' 
select 
WHEI! event=XC_ALLOCATION REQUEST then do 
address cms ‘VHFCLEAR’ 
say ‘Allocation request received for' resid 
CALL Process Request 
end 
WHEN event=XC_CONSOLE INPUT then 
CALL user_input left{buffer, length) 


say ‘Resource management for' resid ‘has been revoked' 
SIGNAL Terminate Server 
end 
OTHERWISE 
say ‘Wait_On_Event returned event XC_INFORMATION INPUT ' 
SIGNAL Terminate Server 
end 
end 
Process Request: 
ADDRESS COHINAND 
RESID 
RETURII 
User_Input: 
arg user_buffer 
select 
WHE! USER BUFFER = ‘STOP’ THEN BO 
say ‘Terminating because of stop' 
exit 
end 
OTHERWISE DO 
ADDRESS CHS USER _BUFFER 
END 
end - 
return 


Figure 78. EXEC to Schedule a Global Resource - RESAPING.EXAC 


Configuring a Private Gateway: A private gateway runs in a user’s “private” virtual 
machine. Within that virtual machine the appropnate TA TLIB and LOADLIB 
members must be globalled to run a program such as APING that 1s wntten in C. 
The following EXEC gives an example of an EXEC that can be called from a user’s 
PROFILE EXEC to set up the virtual machine to act as a server: 


APPC.VM Configuration 105 


/* This exec sets parameters for APPC/VM server operation */ 
PARSE ARG HELP1 
IF HELP1 = '?' THEN DO 
say 'This EXEC sets a user virtual machine for use as an APPC server. ' 


say ‘It:'! 

say ' 1. Performs SET SERVER ON’ 

say ' 2. Performs SET FULLSCREEN OFF' 

say ' 3. Performs SET AUTOREAD OFF! 

say ' 4, GLOBALs loadlib and txtlibs needed for C/370.' 
say 


say 'It can be called from the PROFILE EXEC to automatically enable’ 
say 'APPC server function.' 
exit 0 
end 
TRACE 0 
SET CMSTYPE- HT 
/* Test for existing LOADLIB defs. Add EDCLINK (C runtime) if not */ 
/* configured. * 
‘QUERY LOADLIB (STACK LIFO) '! 
PARSE UPPER. PULL. LLIBS 
I = WORDS(LLIBS) 


EDCADD='YES' 

LOADCMD = ‘GLOBAL LOADLIB ' 

DO J=3 TO I 
IF WORD(LLIBS,J)<>'NONE' THEN LOADCMD=LOADCMD || ' * || WORD(LLIBS,J) 
IF WORD(LLIBS,J)='EDCLINK' THEN EDCADD='NO' | 

END 

IF EDCADD="'YES' THEN LOADCMD=LOADCMD || * EDCLINK' 

INTERPRET LOADCMD 

/* Test for existing TXTLIB defs. Add EDCBASE (C libraries) and ay 


/* and CHSSAA (contains CPI-C routines), if necessary. a 
'QUERY TXTLIB (STACK LIFO) ' | 
PARSE UPPER PULL TLIBS 
I = WORDS(TLIBS) 
-EDCADD='"YES' 
IBHADD='"YES'! 
SAAADD='YES! 
LIBCHD = ‘GLOBAL TXTLIB ! 
DO J=3 70 I 
IF WORD(TLIBS,J)<>'NONE' THEN LIBCMD=LIBCMD || ' ' || WORD(TLIBS,J) 
IF WORD(TLIBS,J)='EDCBASE' THEN EDCADD='NO' 
If WORD(TLIBS,J)='CMSSAA' THEN SAAADD='NO' 
IF WORD(TLIBS,J)='IBMLIB' THEN IBMADD='NO' 


END 

IF EDCADD="YES' THEN LIBCMD=LIBCMD || ' EDCBASE' 
IF SAAADD="YES' THEN LIBCMD=LIBCMD || ' CMSSAA' 
IF IBMADD="YES' THEN LIBCMD=LIBCMD || ' IBMLIB' 


INTERPRET LIBCMD 
"SET SERVER ON' 

‘SET FULLSCREEN OFF' 
"SET AUTOREAD OFF! 


Figure 79. EXEC to Enable Server Operation - RESAPING.EXC 
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How to find.... 


Notes: 


1. The last three lines (SET commands) are required for private server operation. 


When a pnvate gateway 1s used, APPC’VM converts TP names received on 
ATTACH es to executable program names by mapping the TP names to entnes in a 
file called SSERVER$ NAMES. 


* This file is used by APPC server to determine what module or exec 
* to call based on the TP name received in an ATTACH. 
snick. APINGD Hlists* 

> APINGD 


Figure 80. SSERVERS NAMES - TP To Executable Mapping - SSERVERS.NAMI 


In the above example, the TP name APINGD specified in the “:nick” field 1s 
mapped to the executable. The “:lst” field specifies a list of usends authonzed to run 
this TP. The astenck implies that any userid may run the TP. 


If the usend on the ATTACH matches the usend of the virtual machine where the 
TP is to run, then the “:list” entry is not needed. Simularly, if the TP name received 
in the ATTACH! matches the executable name then the “:module” entry is not 
required. If both of these conditions are true then the entire entry in the file can be 
omitted. 


e LU Name 
For APPC VM, this is configured in AGWPROF GCS. The command: 
AGW ACTIVATE GATEWAY ?LUNAME? GLOBAL 
defines a global resource manager with name 7LUNAME?. 

¢ Control Point (CP) Name 


VTAM, being a LEN node, does not have a CP (Control Point) name for 
APPN use. It does, however, have a SSCPNAME (System Services Control 
Point Name). If in configuring a partner platform a CP name 1s needed, use the 
SSCPNAMIE instead. It is also set in the ATCSTRxx file on the VTAM 191 
disk. 


e Network Name 


It 1s defined in a file named ATCSTRxx on VTAM’s 191 disk. The “xx” is two 
digits, and the default is 00. ATCSTRxx 1s the WITAM start options. The 
NETID parameter defines the network name. 


e LAN address 


The LAN address is coded in NCP on a LINE macro using the LOCADD 
parameter. 
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ee 


snodeid 


Appendix A. Using Node IDs tn VTAM 


Prior to VTAM Version 3 Release 2, the only mechanism VWTAM had for resolving 
dynamic connections like dial-in was the node ID. The examples in this guide all 
use a LAN connection which to VTAM is just like dial-in. The node ID is set in 
the computer dialing in and must match the value in VTAM for that physical unit. 


The node ID itself was intended to have two parts: a block number that was to be 
unique for each product type and an /D number that was to be unique within each 
product type. These two parts correspond respectively to the /DBLK and IDNUM 
parameters in VTAM. 


The examples below show for each of the pertinent platforms (LEN peripheral 
nodes and APPN nodes) how to code the node ID in the platform and the corre- 
sponding VT AM definition. 


Note: Some platforms allow you to set the block number; in others it is fixed. If 
the block number is settable you can use any matching value for IDBLK in VTAM. 
If the block number is fixed and VTAM does not use the CPNAME parameter as 
recommended, then the VITAM IDBLK MUST MATCH the block number in the 
product. This will be indicated in the examples. 


Note: Although the information regarding nodeids applies to VTAM releases earlier 
than Version 3 Release 2, the configurations in this guide require function that 1s 
only supported in Version 3 Release 2 and later. 


Node ID for SNA Services/6000 


SNA Services ‘6000 allows you to set the block number; the default is 071. In the 
example below, the “bbb” values must match in VTAM and SNA Services6000. 


PROFILE name ?CPPRO? 
XID node ID bbbnnnnn 


NETWORK name ONE TNAME? 
CONTROL POINT name 2SSCPHAHE ? 


Figure 81. Control Point profile 


The corresponding VIAM definition is as follows: 


?LINKNAHE? PU ADDR=04, X 
CPNAME=?AIXLUNAHE?, X 
IDBLK=bbb, * DEFAULTS TO 071 . X 
TONUM=nnnnn, * ANY 5 HEX DIGITS m X 


MODETAB=?MODETAB? 
PAIXLUNAME? = LU LOCADDR=0,DLOGMOD=#INTER 
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Node ID for AS/400 


The AS 400 calls the node id the local exchange identifier FIXES the block number 
at 056. Below is a sample screen from the Create Controller Description command. 
The controller type/class 1s *HOST. 


Create Ct] Desc (SNA Host) (CRTCTLHOST) 


Type choices, press Enter. 


Controller description..... > ?CONTRNAME? Name 
DINK: CYDE, a ae Si al ee et > *LAN_ *IDLC, *LAN, *SDLC, *X25 
On tinesat: TP <<. ct tees SG Ew *YES *YES, *NO 
APPN=CODADIC -c. 6 i 6 He ee > *NO_ *YES, *NO 
Switched line list ....... Name 
+ for more values 
Maximum frame size. ...... *LINKTYPE 265-16393, 256, 265, 512... 
Remote network identifier ... *NETATR_ Name, *NETATR, *NONE, *ANY 
Remote control point ...... Name, *ANY 
SSCP identifier ........ O50000000000-O5FFFFFFFFFF 
Local exchange identifier .. . 656nnnnn O05600000-O56FFFFF, 
*LIND 
Initial connection. ...... *DIAL *DIAL, *ANS 


Figure 82. Node ID definiuon for AS ‘400 


The corresponding VTAM definition is as follows: 


?LINKNAME? PU ADDR=04, X 
CPNAME=?LUNAME?, X 
IDBLK=656, * MUST BE ©56 FOR AS/400 * X 
IDNUM=nnnnn, * ANY 5 HEX DIGITS - X 


HODETAB=?MODE TAB? 
?LUNAME? =LU LOCADDR=0,DLOGMOD=#INTER 


Node ID for Networking Services/DOS 


Networking Services/DOS calls the block number the block_ID and the ID number 
the /D. The block_ID is settable but defaults to 075. In the example below, the 
“bbb” values must match in VTAM and Networking Services/DOS. 


NSON ?NETWORK?. ?7LUNAME? , bbbnnnnn 


The corresponding VTAM definition is as follows: 


?@LINKNAME? PU ADDR=04, X 
CPNAME=?LUNAME?, Xx 
IDBLK=bbb, * DEFAULTS TO 075 : X 
TONUN=nnnnn, * ANY 5 HEX DIGITS . X 


MODETAB=?MODETAB? 
?LUNAME? =LU LOCADDR=0,DLOGMOD=#INTER 
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Note: For Networking Services, DOS, the LU name and CP name are the same. 
The modetable must include the name #INTER. 


Node ID in OS/2 Extended Services 


OS ‘2 Extended Services calls the ID number the nodeid and the block number 1s 
FIXED at 05D. You MUST tell the VTAM system programmer to set the IDBLK 
to 05D. Below is the example Local Node Characteristics window and NDF 
excerpt. 


Required Features: 
Network ID: 
Local node name: 
Hode type: 
o End Node to Hetwork Node Server 
o End Hode - No Network Node Server 
o Network Node 


Your network node server address: ?LANADDRESS? 


Optional Features 


Local tiode ID 05D nnnnn 
Local Node Alias tame 
Comment Configuration is Fun! 


tivate Attach Manager at start up 


Figure 83. Local Node Characteristics for Extended Services 


define local cp fq_cp_name(?NETWORK?. ?7LUNAME?) 
cp_alias(mylu) 
node_id{x'nnnnn') 
node type(?NODETYPE?) ; 


Figure 84. NDF file excerpt DEFINE LOCAL_CP with nodeid 


The corresponding VTAM definition is as follows: 


?LINKNAME? PU ADDR=04, X 
CPNAME=?LUNAME?, X 
IDBLK=05D, * MUST BE O50 FOR EXT. SVCS.* xX 
IONUM=nnnnn, * ANY 5 HEX DIGITS a‘ X 


MODETAB=?MODETAB? 
?LUNANE? = =LU LOCADDR=0,DLOGHOD=4INTER 
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